# ClixRx MCP Server — Documentation for AI Agents

> ClixRx is a US prescription discount plan. It returns a bounded set of participating-pharmacy
> offers for an exact medication, quantity, and ZIP. A coupon is created only after explicit
> confirmation of one returned offer. It is NOT insurance, NOT a pharmacy, and NOT medical advice.
> Final prices are confirmed at the pharmacy counter.

This generated documentation is published only with the paired live-site and MCP-public gates.
The endpoint's `tools/list` response is the authoritative current tool catalog and schema.

## Connect

**Endpoint:** `https://mcp.clixrx.com/mcp`
**Transport:** Streamable HTTP.

Connect a remote streamable HTTP server named `clixrx` at the endpoint, then call `tools/list`
to confirm the current surface. Human setup guidance is at https://clixrx.com/connect.

For a user asking to add ClixRx, the setup prompt is:

```
Add the ClixRx MCP server to my setup: a remote streamable HTTP server named "clixrx" at https://mcp.clixrx.com/mcp, no authentication. Then list its tools to confirm it connected.
```

Hosts configured by file can use:

```json
{ "mcpServers": { "clixrx": { "url": "https://mcp.clixrx.com/mcp" } } }
```

## Tools

Call `tools/list` for authoritative, current schemas. The canonical server card is
https://api.clixrx.com/.well-known/mcp/server-card.json. The current registered surface is:

| Tool | Purpose |
| --- | --- |
| `find_prescription_discount_prices` | **Preferred** one-call price-shopping workflow: resolve and return bounded participating-pharmacy offers. |
| `search_drug` | Lower-level medication lookup for a composed workflow. |
| `get_prices` | Lower-level price lookup for a verified NDC. |
| `ask_rx_advisor` | Plain-language, non-clinical guidance. |
| `get_coupon` | Retrieve an existing coupon by share token. |
| `get_nearby_pharmacies` | Pharmacy lookup by ZIP. |
| `create_coupon` | Create a coupon after explicit confirmation of one exact returned offer. |
| `generate_wallet_pass` | Generate a wallet-pass link for an existing coupon. |
| `get_recommendation` | Lower-level recommendation across returned offers. |
| `__mcp_health` | Server health and tool-surface introspection. |

## Canonical workflow

1. Call `find_prescription_discount_prices` once with the medication and ZIP, including strength,
   dosage form, and quantity when known.
2. If it returns an ambiguity, ask the user to choose. Otherwise present the returned offers in
   their returned order; do not invent savings or market-wide comparisons.
3. After the user explicitly confirms one exact returned offer, call `create_coupon` for that offer.
4. Present card details only when the coupon result supplies them. Do not mint merely to test a flow.

## Conduct

- Prices are estimates; the pharmacy counter is authoritative.
- Do not provide medical advice; direct clinical questions to a doctor or pharmacist.
- Do not ask for insurance details, medical records, or contact identifiers in MCP tool arguments.
- ClixRx doesn’t transfer prescriptions. Tell users to call the pharmacy directly.

## Discovery

- MCP manifest: https://api.clixrx.com/.well-known/mcp
- Server card: https://api.clixrx.com/.well-known/mcp/server-card.json
- REST API: OpenAPI at https://api.clixrx.com/api/openapi.json, human docs at https://clixrx.com/for-ai
- Agent card: https://api.clixrx.com/.well-known/agent.json
- Site overview for LLMs: https://clixrx.com/llms.txt