Developer docs

Build on Pawsitive Future

The same API that runs the donor and clinic portals: a full REST reference, and the subset of it exposed as MCP tools so an agent like Claude can read what you can read and change what you can change — asking you first, every time, before it changes anything.

What this is

One API, generated docs, two ways in

Runs as you

No service account. Every call — REST or MCP — reaches the API with your own token and passes the same permission checks as the portal. A read or change you hold no grant for comes back as 403, same as it would in the browser.

Reads flow, changes wait

Reads run straight away on either surface. Through MCP, anything that creates, updates or deletes shows you exactly what it will do first, and runs only when you tick confirm — Claude cannot answer that dialog for you.

Always current

Both references below are generated straight from the API's own specification, not hand-written. A new endpoint appears here — and becomes an MCP tool unless it is deliberately excluded — the next time the API deploys.

MCP quickstart

Connect Claude in two minutes

There is no token to copy. Add the server, sign in once in your browser, and the client keeps itself signed in for 90 days.

1

Claude knocks

It calls /mcp and is told where to sign in: a 401 naming this server's sign-in page.

2

You sign in

Your browser opens on api.pawsitivefuture.org. Enter your work email, then the 6-digit code we send.

3

You allow it

A consent screen names the app asking. Allow it, and the browser hands Claude a token.

4

Claude works as you

An hour-long token that renews itself for 90 days. You won't see the browser again until then.

Add the server, then sign in

terminal
# 1 · add the server (once per machine)
claude mcp add --transport http pawsitive-future https://api.pawsitivefuture.org/mcp

# 2 · sign in — opens your browser; or type /mcp in a session and choose Authenticate
claude mcp login pawsitive-future

Claude Desktop or claude.ai: Settings → Connectors → Add custom connector, paste the URL above, then Connect. The same sign-in page opens either way.

Then just ask

Which vouchers are waiting for PFF approval?
What does the voucher pool have left to give?
Approve the claim on that voucher.
Open a support case: batch 7 stopped printing.
When Claude wants to change something

Your client shows you exactly what will be sent. Tick "Make this change" and confirm to go ahead. Decline, close it, or wait 90 seconds, and nothing happens.

pawsitive-future is askingform
Confirm a change to Pawsitive Future
Approve a claimed voucher and credit the clinic (deferred EFT)
POST /api/claims/c-4471/approve
Runs as you@yourorg.org, with your own permissions.
✓Make this change
DeclineConfirm
Reference

Pick a surface