Skip to main content
Glama

tenderscope-lite

A tiny MCP server that lets your AI agent search open EU public tenders live from the official TED Search API.

  • One tool: search_tenders

  • Runs locally over stdio, no database, no account, no API key

  • Returns structured cards (title, buyer, country, budget, deadline, link), not web pages

  • Only tenders whose deadline is still in the future

Want Armenian tenders (ARMEPS) with budgets read from the invitation documents, watchlists, deadline alerts and a hosted API? That is the hosted TenderScope service (free plan included). This package is its open-source thin version.

Install

Requires Node.js 22 or newer.

npx -y github:MarutMarutyan/tenderscope-lite

Or from a clone (the repository already contains the built dist/):

git clone https://github.com/MarutMarutyan/tenderscope-lite.git
node tenderscope-lite/dist/tenderscope-lite.mjs

Related MCP server: public-tenders-es-eu

Connect to Claude Desktop

Open the config file (Settings, Developer, Edit Config) and add:

{
  "mcpServers": {
    "tenderscope-lite": {
      "command": "npx",
      "args": ["-y", "github:MarutMarutyan/tenderscope-lite"]
    }
  }
}

Restart Claude Desktop, then ask: "Find open IT tenders in Germany with a deadline next month."

Connect to Cursor

Add the same block to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "tenderscope-lite": {
      "command": "npx",
      "args": ["-y", "github:MarutMarutyan/tenderscope-lite"]
    }
  }
}

Tool: search_tenders

Argument

Type

Meaning

q

string

Keywords, e.g. software development. May be empty.

countries

string[]

Buyer countries, ISO 3166-1 alpha-2 (EU/EEA), e.g. ["DE","FR"]

cpv

string[]

CPV code prefixes, e.g. ["72"] for IT services

days

integer

Look at notices published in the last N days (1-90, default 30)

limit

integer

Cards to return (1-20, default 10)

Response: { "results": [ { id, title, buyer, country, budget, currency, deadline, publishedAt, cpv, url } ] }. An empty result comes with a hint on how to widen the query. Budget is a string ("125000.00"), dates are ISO 8601 UTC; either may be null when the notice does not state them.

Notes

  • Data comes straight from the TED Search API v3 (no HTML scraping). Be polite: every tool call is one request.

  • Only notice metadata and links are returned, never document texts.

Development

npm install
npm run build   # bundles into dist/tenderscope-lite.mjs
npm test        # tests with a stubbed fetch, no network

The TED notice parser in src/vendor/ is shared with the hosted service and copied from its repository on every release; send fixes as issues or pull requests here and they are carried over.

License

MIT

Available Tools

1 tool
search_tendersAInspect

Search open EU public tenders (TED, live). Returns cards: id, title, buyer, country, budget, currency, deadline, url. Only tenders with a future deadline are returned.

Inputs: q (required), cpv, days, limit, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With a single tool there is nothing to confuse it with, so misselection is impossible. The tool's purpose (searching open EU tenders from TED) is narrow and explicit.

    Naming Consistency5/5

    The lone name search_tenders follows a clean verb_noun snake_case pattern. There are no competing conventions to clash with.

    Tool Count3/5

    One tool is thin even for a 'lite' server; the entire surface is a single search operation. It is defensible for a minimal read-only scope but leaves no room for detail retrieval or filtering.

    Completeness3/5

    Search is covered and returned cards include a url, but there is no get_tender detail lookup, no structured filters (country, CPV, budget range), and no pagination control. Agents can work around the gap via the url but the lifecycle is only partially covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and retrieving detailed information on EU grant calls and tenders from the EU Funding & Tenders Portal, including deadlines, budgets, and topic details.
      86 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Provides normalized search over public-sector tender notices from TED, covering Spain and the rest of the EU. Supports filtering by country, keyword, CPV prefix, and publication recency, returning tender details and related links.
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and retrieve public procurement notices from 17 sources across Germany, the EU, and the UK, with filtering by country, CPV code, deadline, and contract value, plus full tender details and source freshness checks.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to search, count, and validate EU public-procurement notices from the Tenders Electronic Daily database through read-only, keyless queries using keyword, country, CPV, date-range, and expert-syntax filters. It can run locally over stdio or as a token-protected HTTPS connector, returning notice titles, buyers, values, and links.
      4
      MIT