Skip to content
Setcoin Group
Request access
Setcoin API & MCP · Sandbox open

The record, inside your agents.

The Atlas, the Bankability Index and the Setcoin engines, as 12 tools your own agents and systems can call. Connect over the Model Context Protocol or plain REST. Every answer is cited, every call is priced before it runs, and you set the spend cap.

Data5Monitoring1AI answers1Engines4Analysts1
setcoin · mcp sessionExample
$ claude mcp add --transport http setcoin https://setcoin.group/api/v1/mcp
✓ connected · 12 tools
> Which European data-centre projects are shovel-ready but still lack offtake?
→ search_projects { sector: "data-centres", region: "EU", stage: "shovel-ready" }
  ← 50 records · €0.03
→ get_project { project_id: "prj_…" }
  ← sponsor, site, gates, 7 citations · €0.08
→ get_bankability { project_id: "prj_…" }
  ← index 65 · offtake not evidenced · €0.08
✓ answer drafted from the record · every sentence cited
  spend today €4.21 of a €50 cap
25,973live projects behind every call
252,484citations a response can draw on
12tools, one MCP server, one REST API
€0.08per named, cited record · no seat fees
Two doors, one record

Plug it into an agent, or into a back end.

Both doors call the same service layer, so a tool and its endpoint always return the same thing and cost the same. Use MCP when a model decides what to look up. Use REST when your code does.

MCPFor agentsClaude, IDE agents and your own agent frameworks
{
  "mcpServers": {
    "setcoin": {
      "type": "http",
      "url": "https://setcoin.group/api/v1/mcp",
      "headers": { "Authorization": "Bearer sk_test_…" }
    }
  }
}
  • Remote server over Streamable HTTP, authenticated with your API key
  • Tool descriptions written so a model picks the cheapest tool that answers
  • Engines quote first; cost and balance ride in every result
RESTFor systemsBack ends, data warehouses, BI and webhooks
curl "https://setcoin.group/api/v1/projects\
  ?sector=bess&country=UK&min_index=60" \
  -H "Authorization: Bearer sk_test_…"

HTTP/1.1 200 OK
X-Setcoin-Cost: 0.03
X-Setcoin-Balance: 412.40
  • JSON over HTTPS, an OpenAPI spec, cursor pagination
  • Signed webhooks when a gate, stage or index changes
  • Cost and balance on every response

Keys above are examples. Start free on Sandbox, read the OpenAPI spec, or check live status.

The tool catalogue

12 tools, from a three-cent search to a full claim check.

Pick a tool to see what it takes, what it returns and what it costs. The same list is published as JSON at /api/v1/catalog.json.

search_projects · example callExample
MCPtools/call search_projects
RESTGET /v1/projects

Filter the Atlas by sector, region, stage, capex and Bankability Index.

  • 50 results · page 1 of 4
  • stage: shovel-ready 31 · bankable 19
  • each with project_id, index, gates
€0.03per query · Up to 50 anonymised records with stage, index and gate flags
The architecture

Four layers between your agent and the record.

Clients call one edge. The edge checks who you are and what you may spend, the services do the work, and the core is the same record, index and engines the Setcoin workspaces use.

ClientsClaude & MCP clientsIDE and coding agentsYour back endWarehouse & BIWebhook receivers
EdgeAPI gatewayKeys + OAuth 2.1 scopesRate limits per planSpend caps · 80% alertsAudit log
ServicesMCP serverREST /v1Engine queueWebhook dispatcherMetering
CoreThe record · 25,973 projectsBankability IndexCapital Map & tendersKnowledge graph94 public sources
The life of one call

Eight steps, in about the time it takes to read this line.

Every call takes the same path, so cost, citations and limits behave the same whether a person or an agent is calling. Tap a step to stop on it.

Step 1 of 8

Authenticate

An API key or an OAuth token. Each key carries scopes, so a read-only key can never start an engine.

Authorization: Bearer sk_live_…
Built for agents that spend money

Six guardrails, on by default.

Cited or silent

Answers come from the record only. No citation, no claim.

Spend caps

A daily and a monthly cap on every key, with an alert at 80%.

Quote, then confirm

Engine calls above €10 return a price before they run.

Scoped keys

Read-only, engine and webhook scopes, rotated without downtime.

Companies, not people

Verify checks companies and vehicles, never individuals.

Your files stay yours

Documents you send are private to your account and never used to answer anyone else.

Setcoin data describes projects and their public record. It is not investment advice and does not state or imply any return.

Pricing

Pay for what your agents use, never for seats.

Every call has one price. Paid plans are a monthly minimum that usage draws down, not a fee on top. Move the sliders to see which plan fits.

Estimated monthly bill——

    Indicative, in euros, before VAT. Usage is billed against the plan minimum; the cheapest plan for your mix is picked for you.

    SandboxFreeBuild and test · no card
    • Test keys, MCP and REST
    • 250 search calls and 25 record reads a month
    • Names and sponsors masked, no engines
    • Community support
    Get a test key
    Build€490 / month minimumOne product or agent in production
    • Monthly minimum, drawn down by usage
    • Every tool, engines included
    • Webhooks on gate changes
    • Spend cap, alerts at 80%
    Request access
    Scale€2,490 / month minimumPlatforms and data teams
    • Everything in Build
    • 25% off data calls
    • 300 requests a minute
    • Bulk export and priority support
    Request access
    EnterpriseAnnual poolBanks, funds, OEMs · annual prepaid pool
    • From €36,000 a year, prepaid
    • Pool bonus on engine calls
    • SSO, private networking, SLAs
    • Commercial-use and redistribution rights
    Talk to us

    Indicative prices in euros until a signed order form. Analyst-signed work (Verify Snapshot, DD reports) is not metered: request it through the API and it is quoted on the standard price book.

    How we roll it out

    Five phases, each with a gate it must pass.

    Nothing moves to the next phase until its exit gate is met. All five phases are built: every model call logs its real cost, the REST API and the MCP server share one metered core, engines quote before they run, and Sandbox, Build and Scale are self-serve. General availability waits on legal sign-off of the API terms. The machine-readable spec is at /api/v1/openapi.json.

    1. 0
      InstrumentBuilt · measuringWeeks 1–2
      • Log tokens, paid extracts and run time on every engine run
      • Usage per account and per key

      Exit gate Measured cost for every tool; the price book re-checked against it

    2. 1
      Read APIBuiltWeeks 3–6
      • Gateway, keys and scopes
      • Projects, records, Bankability Index, tenders
      • Sandbox plan and an OpenAPI spec

      Exit gate Design partners in production, p95 under 400 ms, no billing errors

    3. 2
      MCP server + meteringBuiltWeeks 7–10
      • Remote MCP server with the data tools and Ask the Atlas
      • Usage meters, spend caps, cost headers

      Exit gate MCP and REST return identical results for the same call

    4. 3
      Engines over APIBuiltWeeks 11–14
      • Engine jobs with quote-then-confirm
      • Gate, Verify, Claim and bid tools
      • Webhooks and Watch

      Exit gate Engine results match the workspace engines on a shared test set

    5. 4
      General availabilityBuilt · awaiting sign-offWeeks 15–20
      • Build and Scale self-serve, Enterprise pools
      • Status page; SSO and SLAs in Enterprise order forms
      • API terms and data licence (draft)

      Exit gate Legal sign-off, security review, first Enterprise pool

    Get access

    Put the record in your stack.

    Open a free Sandbox account and create test keys in a minute: start here. Build and Scale subscribe by card from the same page. For an Enterprise pool, or to tell us what your agent needs, use the form.

    Request API & MCP access

    We reply within one working day.

    I am a

    Setcoin API & MCP

    Questions about the API and the MCP server

    What is the Setcoin MCP server?

    A remote Model Context Protocol server that gives any MCP-compatible agent 12 tools on the Setcoin record: search, cited project records, the Bankability Index, tenders, capital fit, AI answers and the Setcoin engines.

    How is the API priced?

    Per call, in euros: €0.03 a search, €0.08 a named cited record, €0.75 an AI answer, and engines from €50. Build is a €490 monthly minimum that usage draws down; Sandbox is free.

    Can an agent run up a large bill?

    No. Every key has a daily and a monthly spend cap, alerts at 80%, and any engine call above €10 returns a quote that must be confirmed before it runs.

    Where does the data come from?

    The same record the Atlas draws: 25,973 live projects built from 94 public sources, with a citation on every fact.

    Is the API available now?

    Yes. Open a free Sandbox account from your Setcoin login and create test keys: every data tool, with names masked and monthly limits. Build and Scale subscribe by card and unlock named records, Ask the Atlas, engines and watches over REST and MCP. Enterprise pools are agreed with the team. The API terms are still a draft pending legal review.