Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "counselorai": {
      "type": "http",
      "url": "https://api.counselorai.app/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}

claude mcp add --transport http counselorai https://api.counselorai.app/mcp --header "Authorization: Bearer ${api_key}"

[mcp_servers.counselorai]
url = "https://api.counselorai.app/mcp"
bearer_token_env_var = "api_key"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "counselorai": {
      "type": "remote",
      "url": "https://api.counselorai.app/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:api_key}"
      }
    }
  }
}

{
  "mcpServers": {
    "counselorai": {
      "type": "http",
      "url": "https://api.counselorai.app/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=counselorai&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmNvdW5zZWxvcmFpLmFwcC9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHthcGlfa2V5fSJ9fQ%3D%3D"
}

{
  "servers": {
    "counselorai": {
      "type": "http",
      "url": "https://api.counselorai.app/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}

{
  "mcpServers": {
    "counselorai": {
      "httpUrl": "https://api.counselorai.app/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}

extensions:
  "counselorai":
    enabled: true
    name: "counselorai"
    type: streamable_http
    uri: "https://api.counselorai.app/mcp"
    headers:
      "Authorization": "Bearer ${api_key}"
    timeout: 300

Placeholders to fill from your own secret store: ${api_key}. The registry never accepts secret values.

Quality 83 / 100good

protocol100 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
pass
protocol.list_ttltool list is cacheable (ttlMs 300000)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations13 of 13 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: humanize (idempotentHint); quote_call (destructiveHint, idempotentHint, openWorldHint); rec (idempotentHint); …
pass
tools.token_costabout 4,222 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability50 · weight 15

pass
stability.changes1 tool changes in 30 days
fail
stability.rug_pull1 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

13 tools, about 4,222 tokens to load them all · tool set 2a75fa27e5e8 · tools last changed 2026-10-07 · checked 2026-10-20 19:10 UTC

Tool changes

2026-10-07scholarshipchangedtitle, descriptionmeaning changed
before
Surface scholarships worth this student's time and the angle their application should take for each. Runs a live web search, so it is slower and costs more than the other analysis tools, and the output carries a verification warning because scholarship programs change year to year. Treat the result as a research starting point. Cost: about 165 credits (~$0.165) per call.
after · 35% of words in common
Search for current scholarship pages to review. A page in the result is a research lead, not a verified match. Confirm program terms, deadline, and student eligibility on the sponsor page before advising the student. Live web search makes this slower and costlier than the other analysis tools. Cost: about 165 credits (~$0.165) per call.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 77 / 100

no-repository

provenance45

liveness100

freshness85

hygiene80

+website +reachable +uptime-100% ~updated-49d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.counselorai.app/mcp` streamable-http	none	yes	100%	478 ms	2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26	2026-10-20

Tools (13)

`account_balance`read-only	Free. Returns the credits left on this API key. Call it before a long run of billed calls.
`aid`	Explain what a family is likely to see across a list of schools and why, in plain language. An explanation for a counselor to walk a family through, never an official determination, and the output says so. Cost: about 73 credits (~$0.073) per call.
`appeal`	Draft a financial aid appeal letter to a college financial aid office. Call this when a family needs to ask for a review of an award: income dropped, an expense appeared, another school offered more, or the FAFSA was wrong. Returns the letter, not advice on whether to appeal. Runs a 5-step drafting pipeline, so it is the most expensive tool here and the slowest, typically 30 to 60 seconds. Cost: about 353 credits (~$0.353) per call.
`awardlens`read-only	Break down one to three financial aid award letters: what is grant, what is loan, what is work-study that has to be earned, what the supported net price is, and what renewal conditions are buried in the language. Identifies missing facts and questions for the aid office. With more than one letter it compares them side by side. Read-only. Cost: about 173 credits (~$0.173) per call.
`fafsa`	Produce a FAFSA action checklist for one student, keyed to their grade, dependency status and income band. Answers the process question a family actually has: what do we do, in what order, by when. Does not compute an award. Cost: about 87 credits (~$0.087) per call.
`humanize`read-only	Rewrite reader-facing prose so it sounds direct, specific, and personal without changing facts or inventing a voice. Use it for outreach, emails, letters, posts, and narrative copy. It preserves quoted text and checks the result against the source. It does not evade or promise to beat AI detectors. Do not use it for code, SQL, JSON, legal text, or technical specifications. Cost: about 413 credits (~$0.413) per call.
`letterlens`read-only	Analyze a finished recommendation letter and return specific fixes: what is vague, what is asserted without evidence, what reads as generated. Read-only and far cheaper than drafting. Use it to critique a draft, not to rewrite one, and use revision to apply the fixes. Cost: about 93 credits (~$0.093) per call.
`profile`	Turn raw counselor notes into a structured student profile. Run this first when working one student across several tools: it is cheap, and its output is good input for the relationship, traits and story fields on rec, or keyDetails on appeal. Cost: about 87 credits (~$0.087) per call.
`quote_call`read-only	Free. Validates the input for a tool and returns the exact credit hold a real call would take at your price, plus whether your balance covers it. Use it to budget before a billed call or to lint an input for free.
`rec`	Draft a letter of recommendation from counselor notes. Call this to WRITE a letter. To critique one that already exists, call letterlens instead, which is much cheaper. Runs the same 5-step pipeline as appeal. Cost: about 369 credits (~$0.369) per call.
`revision`	Apply one instruction to an existing letter and return the revised text. Pair it with letterlens: review to find the problems, revise to fix them. Changes only what the instruction asks for. Cost: about 97 credits (~$0.097) per call.
`scholarship`	Search for current scholarship pages to review. A page in the result is a research lead, not a verified match. Confirm program terms, deadline, and student eligibility on the sponsor page before advising the student. Live web search makes this slower and costlier than the other analysis tools. Cost: about 165 credits (~$0.165) per call.
`translate`read-only	Translate counselor-facing output into a family's language, holding the financial aid terms in English on purpose. FAFSA, Pell, SAI, COA and the loan names stay untranslated so a family can match what the school actually sends them against what they were told. Read-only. Cost: about 173 credits (~$0.173) per call.

Schemas: list_tools.

Similar MCP servers

More from io.github.The-825

Official server.json

{
  "name": "io.github.The-825/counselorai",
  "title": "CounselorAI",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.counselorai.app/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer {api_key}",
          "variables": {
            "api_key": {
              "isSecret": true,
              "isRequired": true,
              "description": "A CounselorAI bm_test_ or bm_live_ API key.",
              "placeholder": "bm_test_..."
            }
          },
          "description": "CounselorAI API key. Create a free test key at https://api.counselorai.app/v1/accounts."
        }
      ]
    }
  ],
  "version": "1.2.0",
  "websiteUrl": "https://counselorai.app",
  "description": "College-access writing and financial-aid analysis tools for counselors, students, and families."
}