AI assistant connection
Use ProseMap from an AI assistant
ProseMap has a connector that speaks the Model Context Protocol (MCP). An assistant connected to it can estimate, run and read ProseMap analyses on your account, within a spending limit you set. It uses the same account, saved results, credit and rules as the web app.
Set it up
- Sign in to the app, open Account, and under Connect an AI assistant create a connection. Give it a name and a monthly spending limit.
- Copy the token. It is shown once.
- Add ProseMap to your assistant as a remote MCP server (HTTP transport):
Server URL https://www.prosemap.io/api/mcpHeader Authorization: Bearer <your token>
If your assistant only accepts a URL and cannot send a header, use https://www.prosemap.io/api/mcp/<your token> instead. Treat that URL as a password.
Claude Code
ProseMap has been verified end to end with Claude Code. Add it with:
claude mcp add --transport http prosemap https://www.prosemap.io/api/mcp --header "Authorization: Bearer <your token>" |
Other assistants that support remote MCP servers over HTTP with a bearer token should work the same way. They are not listed here until the full journey has been tested with each.
What the assistant can do
| Tool | What it does | Cost |
|---|---|---|
| estimate_analysis | Says what analysing a text would cost, and whether a saved analysis already exists | Free |
| submit_analysis | Starts an analysis within a maximum you state | Same price as in the app |
| get_analysis | Progress, then scores, bands, ranked hotspots and a link to the full visual report | Free |
| get_sentences | Each sentence's score, band, role and flags, and its handoff to the next | Free |
| get_guidance | The revision guidance as Markdown: your draft with a comment at every sentence and handoff that needs work, plus your saved notes | Free |
| explain_sentence | Why a sentence scored as it did | Same price as in the app; free to reopen |
| compare_versions | Score changes between two analysed drafts | Free |
| list_analyses | Your saved analyses | Free |
| get_balance | Your credit and how much of the connection's limit is used | Free |
Improving a draft toward a target score
An assistant can work in rounds. Each round is one analysis; everything else in it costs nothing.
estimate_analysis: see the price. Agree with the assistant what you authorise, how many rounds, and what score you are aiming for.submit_analysis, thenget_analysisuntil it is complete.- If the overall score meets your target, or no hotspots are left, stop.
get_guidance: the assistant revises the draft exactly as the comments say, and nothing else.submit_analysisagain with the revised text andrevision_ofset to the previous id. The result now reports the change from the previous round.- Back to step 3.
Three rounds is usually enough. A score of 75 or more is in the Strong band; most good prose sits between 70 and 85, and a higher number is not always better writing. The connector tells the assistant to stop when a round does not raise the score, and the same instructions are sent to the assistant when it connects.
A request you can paste: "Analyse this draft with ProseMap. Revise it from the guidance and re-analyse until the overall score reaches 80, for at most three rounds and $3 in total. Show me the score after each round and do not change sentences the guidance did not flag."
Limits and safeguards
- Spending limit. Each connection has a monthly limit that ProseMap enforces itself. An assistant cannot raise it or spend past it, whatever it asks for.
- Nothing runs unpaid. Only two tools use a model:
submit_analysisandexplain_sentence. Each reserves its maximum from your balance before it starts and is refused if the balance cannot cover it. Every other tool is free and calls no model. - Per-analysis maximum. Every analysis is started with a stated maximum and is never charged more than that. A failed analysis costs nothing.
- Same rules as the app. Credit is spent in the same order, saved results are free to reopen, and complimentary access applies in both places.
- Not a general model. The connector only exposes ProseMap's own analyses. It does not answer arbitrary prompts.
- Size. Up to 400,000 characters per document. Long documents take a few minutes; the assistant polls for the result.
- Dictation, notes and disagreements are in the web app only. The assistant can open the full report by giving you its link.
- Revoking. Remove a connection in Account and its token stops working immediately.
ProseMap's scores and explanations are produced by AI models. They can be wrong, incomplete or misleading, and they are one reader's judgment rather than an objective measure of writing quality. Check anything that matters independently.