# CounselorAI

> College-access writing and financial-aid analysis tools for counselors, students, and families.

- name: io.github.The-825/counselorai
- version: 1.2.0
- connection class: R0 (autonomous)
- trust: 77/100 flags: no-repository
- quality: 83/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.The-825%2Fcounselorai
- tools: https://api.protogrid.dev/v1/servers/io.github.The-825%2Fcounselorai/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

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

Placeholders to fill: `${api_key}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 85
- provenance: 45
- drivers: +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.

## Quality 83/100 (good)

### protocol: 100 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 300000)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 13 of 13 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: rec (idempotentHint); letterlens (idempotentHint); fafsa (idempotentHint); …
- pass `tools.token_cost`: about 4,222 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 50 (weight 15)

- pass `stability.changes`: 1 tool changes in 30 days
- fail `stability.rug_pull`: 1 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 4,222 tokens to load them all
- tool set hash: 2a75fa27e5e8dff80e48a012d4285d4f
- tools last changed: 2026-10-07T06:50:25.317Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.The-825/counselorai.svg)](https://protogrid.dev/servers/io.github.The-825/counselorai)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-07 `scholarship` changed (title, description) **meaning 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: 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: https://api.protogrid.dev/v1/servers/io.github.The-825%2Fcounselorai/changes

## Remotes

- https://api.counselorai.app/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (13)

- `account_balance`: 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`: 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`: 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`: 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`: 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`: 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.