REST API لبيانات المناقصات والترسيات الحكومية

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-tender-data-api/SKILL.md.
3. Using the Sell to State REST API with my API key, fetch the awards of the last 7 days for <what my company sells> in <countries> and push them to <my CRM or sheet>.

---
name: selltostate-tender-data-api
description: REST API with Sell to State data (government tenders and contract awards from official procurement sources). Use when the user wants to call the Sell to State REST API from code, a script or a pipeline.
---

# REST API (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

Using the Sell to State REST API with my API key, fetch the awards of the last 7 days for <what my company sells> in <countries> and push them to <my CRM or sheet>.

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

## Steps

1. Base URL https://app.selltostate.com/api/v1. Send `x-api-key: $STS_API_KEY` on every call. Check the plan: `GET https://app.selltostate.com/api/v1/whoami`.
2. Tenders: `GET https://app.selltostate.com/api/v1/search?scope=tenders&q=<words>&country=<slugs>&accepts_bids=true&published_days=7`. Awards: `GET https://app.selltostate.com/api/v1/awards?country=<slug>&q=<words>&awarded_days=7&page=1&page_size=100`.
3. Page through the results until you have `total` rows. Remove duplicates by `id`.
4. The full spec: https://app.selltostate.com/api/openapi.json.
5. Limits: 300 search calls and 120 data calls per minute per key. On 429, wait `Retry-After` seconds.

## 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