Let your AI agent search government tenders

1. Sign me in yourself. Try this first: you need me only for one approval click.
- If you can send HTTP requests: POST https://app.selltostate.com/api/v1/agent/signup with JSON {"client_name": "<your app name>"}. Show me verification_uri_complete from the reply as a link. I open it, sign up free with Google or email, and approve the code. Every "interval" seconds, POST token_endpoint with {"device_code": "<device_code>"} until the reply has access_token. Send access_token in the x-api-key header to the MCP server https://app.selltostate.com/api/mcp.
- If you cannot send HTTP requests: tell me to add the MCP server https://app.selltostate.com/api/mcp in this app. Its sign-in page also creates the free account. Claude: Customize > Connectors > Add custom connector. ChatGPT: chatgpt.com/plugins > + > Add custom MCP server, choose OAuth. Claude Code: claude mcp add --transport http selltostate https://app.selltostate.com/api/mcp, then /mcp > Authenticate.
2. The tools are free to connect. A free account gets plan_search 3 times a day and search for 2 different searches a day: titles, buyers, status and dates. Amounts, winners and notice links need a plan. Call whoami to see my plan. Read the skill at https://www.selltostate.com/skills/selltostate-ai-agent-tender-search/SKILL.md.
3. Find open tenders for <what my company sells> in <countries>, show who won similar contracts in the last 12 months, and save the search so I can turn on its email alert.

---
name: selltostate-ai-agent-tender-search
description: AI agents: Claude, ChatGPT and MCP with Sell to State data (government tenders and contract awards from official procurement sources). Use when the user wants their AI agent (Claude, ChatGPT, Cursor or another MCP client) to search tenders and awards.
---

# AI agents: Claude, ChatGPT and MCP (Sell to State)

## Access

1. MCP: the server https://app.selltostate.com/api/mcp (OAuth, or the x-api-key of the agent sign-in: POST https://app.selltostate.com/api/v1/agent/signup, the user approves one code). Call `whoami`. `active` false is a free account: `plan_search` and `search` only, 1-2 searches a day.
2. REST: https://app.selltostate.com/api/v1 with the header `x-api-key`. Read the key from `STS_API_KEY` and never print it.
3. No plan yet: the user picks a plan at https://app.selltostate.com/plans, or you run the agent signup in "Get access" of https://www.selltostate.com/skills/selltostate/SKILL.md. The user pays in the browser.

## Task

Find open tenders for <what my company sells> in <countries>, show who won similar contracts in the last 12 months, and save the search so I can turn on its email alert.

Ask the user for each value in <angle brackets> before the first call.

## Steps

1. Connect the MCP server https://app.selltostate.com/api/mcp. No key yet: POST https://app.selltostate.com/api/v1/agent/signup, give the user verification_uri_complete (one approval click, free account), then poll token_endpoint for the x-api-key. An app without HTTP requests adds the server with OAuth.
2. Call `whoami`. If `active` is false, the account is free: `plan_search` and `search` work for 1-2 searches a day. For more, give the user the plans link.
3. Open tenders: `search` with `scope=tenders`, `q`, `country`, `accepts_bids=true`. Awards: `search_awards` with `country` and `q`.
4. Who won: `search` with `scope=suppliers`, then `get_supplier_detail`. Buyers: `search` with `scope=buyers`, then `get_buyer`.
5. Save the search with `save_search`. The user turns on its email alert at https://app.selltostate.com/alerts.

## Rules

- Give `source_url` (the official notice) for each tender and award. The user reads the documents and bids on the official portal.
- Amounts are in the source currency. Do not add amounts in different currencies.
- The data shows awards, not bids. Do not say that a company lost a tender.
- On a 402, show the message and the link to the user, then stop. On a 429, wait `Retry-After` seconds.
- Credit the data: "Data: Sell to State (selltostate.com)".

More skills (open tenders, buyer research, competitor wins, alerts, API reference): https://github.com/getbeton/selltostate-skills