Skip to content

Provider API keys

Providers connect with an API key rather than a sign-in page. The same key works for agents connected to https://mcp.famasi.ai/mcp and for the Provider API.

Get your key

Your team manages keys in Aide. If you don’t have access yet, email [email protected].

Use it in your agent

Send the key in a header called x-api-key. Each app does this differently:

Keep the key out of anything you commit. Where your app allows it, read the key from an environment variable:

Terminal window
export FAMASI_PROVIDER_API_KEY=YOUR_PROVIDER_API_KEY

Use it in your own code

Terminal window
curl "https://dispensaryapi.famasi.africa/api/v1/providers/formulary?search=amoxicillin" \
-H "x-api-key: $FAMASI_PROVIDER_API_KEY"

Replace your key

Call POST /me/token on the Provider API to refresh your key, then update it everywhere you use it.