Plug Irish tender intelligence into your AI stack
Plug Irish tender intelligence into your AI stack. Search, match, analyse and draft Irish public tenders over REST or MCP, from any agent.
What it is
TenderBuilder's tender search, matching, assessment and drafting engine, callable from your own AI stack. You keep your existing model, whether that is Claude, a ChatGPT-class agent, or a backend job. The API does the accurate Irish-procurement work: matching live eTenders notices to a company, pulling the requirements and scoring criteria out of a buyer's pack, drafting answers that map to the marking scheme, and checking compliance before submission. Two ways in, one key: a REST API, and an MCP endpoint for MCP-capable agents.
What you can build
- A tender radar for a client baseRun
matchacross every company you look after and surface the tenders worth a look, with a one-line reason and a strong-or-possible verdict. A shortlist for a human, not an auto-decision. - Bid or no-bid triage inside your own toolsUpload the buyer's pack, read back the requirements, the award weightings and a bid/no-bid brief, and put that verdict in front of your team before anyone commits a week to a submission.
- Drafting behind your own UIDraft answers written to where the marks are, grounded only in facts about the business, and have your own answers graded for word limits, coverage and grounding. Every draft comes back flagged for human review. Nothing here files a bid.
Quickstart
Create a key at Profile → API keys (workspace admins only), then confirm it before any paid call. GET /me is free, needs no scope and touches no credits.
# 1. Create a key at Profile → API keys, then confirm it (free, no credits):
curl https://tenderbuilder.ie/api/v1/me \
-H "Authorization: Bearer tb_live_..."
# 2. Find live tenders that fit a company (3 units):
curl -X POST https://tenderbuilder.ie/api/v1/match \
-H "Authorization: Bearer tb_live_..." \
-H "Content-Type: application/json" \
-d '{"description":"Dublin managed IT provider: M365, networks, cybersecurity, helpdesk."}'For an MCP client that reads an mcpServers block, point it at the MCP endpoint through the mcp-remote bridge, which forwards your key as a header:
{
"mcpServers": {
"tenderbuilder": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://tenderbuilder.ie/api/v1/mcp",
"--header", "Authorization: Bearer tb_live_..."
]
}
}
}The full endpoint list, the workflow order, the async polling model and every error code are in the developer docs. The machine-readable spec is at /api/v1/openapi.json (no auth needed).
What things cost
Two separate currencies. API units are a monthly allowance for the cheap AI endpoints, counted per workspace over the calendar month. Tender credits are the same currency the app already uses: one is consumed when a full drafting run finalises. Search and reads are free. These figures are defaults and can change, so GET /me is always the authoritative live budget.
| Plan | API units / month |
|---|---|
| Free | 25 |
| Starter | 100 |
| Business | 300 |
| Agency / Team | 1,000 |
| Endpoint | Cost | What it does |
|---|---|---|
| Search + all reads | Free | Public procurement index, and reading your own projects. |
| Derive profile | 1 unit | One AI call to summarise a company for matching. |
| Match | 3 units | Shortlist live tenders against a company. |
| Review | 3 units | Grade up to 5 of your own answers. Batch them. |
| Analyse / Draft | 1 tender credit | Full analysis and drafting, the app currency. |
Where it's honest about its limits
- Bearer-key auth only, today. There is no OAuth yet, by design. Hosted connector directories that require an OAuth handshake cannot attach to it. Use a client that lets you set a static Authorization header.
- The corpus is public eTenders notices. It is a cached index refreshed by one polite daily crawl, provided with attribution for your own bidding use, never for bulk resale. Each listing carries a freshness marker and a link to the source of record.
- Nothing files a bid. There is no submission endpoint. Drafts and packs are for a person to review, edit and submit, and every draft response says so.
- We do not guess at numbers.Where a buyer's documents do not state a value, a deadline or a threshold, you get
(not stated), not an estimate.
Get a key
Sign up, open Profile → API keys, and mint a key with the scopes your integration needs. The free tier gives you 25 units a month to build against before you commit to a plan.
Frequently asked questions
- What can I call the API from?
- Any backend, or any agent that speaks REST or MCP. It works from Claude (Claude Code, or a JSON-config client via mcp-remote), from ChatGPT-class function-calling using the OpenAPI spec, from LangGraph or CrewAI, or from your own server code. You keep your existing model and subscription; these tools do the Irish-procurement work.
- How does authentication work today?
- A bearer API key (tb_live_...), created at Profile → API keys by a workspace admin. Keep it server-side: there is deliberately no CORS, so a key in a browser is exposed. There is no OAuth yet, by design, which is why hosted connector directories that require an OAuth handshake cannot attach to it. Clients that let you set a static Authorization header work today.
- What does it cost to call?
- Two currencies. API units are a monthly allowance for the cheap AI endpoints (25 free, 100 Starter, 300 Business, 1000 Agency per workspace per month). Search and reads are free; derive is 1 unit, match and review are 3 each. Full analysis and drafting consume a tender credit, the same currency the app uses. GET /me is the authoritative live budget.
- Where does the tender data come from?
- A cached index of public Irish eTenders notices, refreshed by one polite daily crawl. Every listing carries a freshness marker and a link to the authoritative record, and is provided with attribution for your own bidding use. We do not scrape eTenders on demand, and there is no bulk resale of the corpus.