↑↓ navigeer ↵ maak oop esc maak toe
MCP-oor-HTTP · 26 nutsmiddels

Verkrygingsdata wat jou agent self kan gebruik.

Point any MCP-capable client — Claude Desktop, Claude Code, Cursor, or your own agent — at our streamable-HTTP endpoint. It can search government tenders and contract awards from official sources, drill into buyers and suppliers, keep lists, and even self-register and pay for access with no human in the loop.

# Eindpunt

https://app.selltostate.com/api/mcp

# Lys die nutsmiddels (oop, geen magtiging nodig)

curl -s https://app.selltostate.com/api/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"tools/list"}'

tools/list is open; tools/call resolves your credential and 402s if un-entitled.

Add it to your client.

Clients with a browser sign you in with OAuth. Other clients send an API key from your account. The server is in the official MCP Registry as com.selltostate/mcp.

Claude

Customize, then Connectors. Select + Add, then Add custom connector. Paste the URL and select Connect.

https://app.selltostate.com/api/mcp
Step by step →

ChatGPT

On chatgpt.com/plugins, select + and Add custom MCP server. Paste the URL and choose OAuth.

https://app.selltostate.com/api/mcp
Step by step →

Claude Code

Add the server, then run /mcp and choose Authenticate.

claude mcp add --transport http selltostate https://app.selltostate.com/api/mcp
Step by step →

Gemini CLI

Install the extension. Gemini CLI opens your browser to sign in.

gemini extensions install https://github.com/getbeton/selltostate-skills
Step by step →

Cursor and other clients

Add the server to mcp.json with your API key in the x-api-key header.

{
  "mcpServers": {
    "selltostate": {
      "url": "https://app.selltostate.com/api/mcp",
      "headers": { "x-api-key": "sts_..." }
    }
  }
}

Die konneksievloei.

  1. 1

    Ontdek

    Kliënte wat aan die spesifikasie voldoen, lees /.well-known/oauth-protected-resource (RFC 9728) en /.well-known/oauth-authorization-server (RFC 8414) om die hulpbron, uitreiker en omvang te bepaal.

  2. 2

    Registreer

    Sonder 'n vooraf gedeelde geloofsbrief registreer die kliënt self via RFC 7591 DCR (POST /api/oidc/register) en kry 'n client_id met nul dataskopes plus 'n payment_link.

  3. 3

    Authenticate

    Clients with a browser (Claude, ChatGPT, Cursor) run the OAuth 2.1 authorization-code flow with PKCE, and you sign in with your Sell to State account. An agent without a browser presents the issued client as Authorization: Bearer client:<client_id> on every tools/call.

  4. 4

    Teken in

    Totdat die kliënt se subjek geregtig is, gee elke tools/call dieselfde 402-liggaam terug as REST — 'n mensgerigte payment_link en die agent-gebore machine_payment-vermoë. Die agent roep pay aan, word buite-sessie gedebiteer, en sy volgende oproep gee data terug.

26 nutsmiddels, met REST-pariteit.

Every tool mirrors a REST endpoint 1:1. Owner-scoped list / saved-search tools require a user API key; an OIDC client token gets a requires_user_key result. Full schemas in the reference.

whoami data:read Identiteit + geregtigheid + omvang (onbeperk — verifieer voor jy spandeer).
search data:read Fasetsoektog oor een omvang: tenders | buyers | suppliers | sectors.
search_awards data:read Toekenningverkenner (q, staatsinstansie, verskaffer, kategorie, jaar, bedragreeks).
get_buyer data:read Besonderhede van staatsinstansie (get_buyer_detail is 'n behoue alias).
get_supplier_detail data:read Verskafferbesonderhede met top-staatsinstansies + sektorverdeling.
get_sector / get_tender data:read Sektorprofiel · enkele toekenning + verwante toekennings.
list_buyers / list_suppliers / list_sectors data:read Top-N staatsinstansies, verskaffers, en die sektor-taksonomie.
get_lists / create_list / add_to_list … data:read CRUD vir gestoorde toekenninglyste — vereis 'n gebruiker-API-sleutel.
get_saved_searches / save_search … data:read CRUD vir gestoorde soektogte — vereis 'n gebruiker-API-sleutel.
export data:export Voer 'n gefiltreerde toekenningstel uit as CSV.
pay billing:pay Betaal outonoom met 'n Stripe-token om toegang te ontsluit — geen betaalbladsy nodig nie.

Roep 'n nutsmiddel aan.

curl -s https://app.selltostate.com/api/mcp \
  -H "Authorization: Bearer client:c_abc123" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search",
                 "arguments":{"scope":"tenders","q":"cloud","year_min":2024}}}'

Sodra verbind, vra net

  • → "Deursoek Sell to State vir kuberveiligheidstoekennings in 2024 en som die top 5 verskaffers op."
  • → "Trek elke toekenning wat die Ministerie van Onderwys vanjaar gemaak het en voer dit uit as CSV."
  • → "Gebruik get_buyer op die relevante staatsinstansie — van wie koop Singapoer konstruksiedienste?"

Verbind jou agent.

Create an account, generate an API key, and point your MCP client at https://app.selltostate.com/api/mcp. Agents can also self-register and pay without a dashboard. Full tool docs at docs.selltostate.com.

Start for free →
Registreer