Developer docs

Connect Kontrakk's federal contract and grant data to any MCP client — Claude Desktop, Cursor, ChatGPT, and more — through our read-only Model Context Protocol API.

Available on Business & Enterprise plans

Overview

The Kontrakk MCP server lets your AI assistant search and read live federal opportunities without leaving its workflow. It is a remote MCP endpoint speaking JSON-RPC 2.0 over HTTP at:

https://kontrakk.com/api/mcp

Quick start

On a Business or Enterprise plan, open Settings → Integrations and create an API key. Copy it — it is shown only once.
Add the server to your MCP client config with the key as a bearer token:

{
  "mcpServers": {
    "kontrakk": {
      "url": "https://kontrakk.com/api/mcp",
      "headers": { "Authorization": "Bearer kk_live_your_key" }
    }
  }
}

Authentication & security

Every request must send Authorization: Bearer <key>. The endpoint never uses session cookies.
Keys are opaque and stored only as a hash — the raw value is shown once at creation.
Keys expire after 90 days by default and can be rotated or revoked anytime from Settings.
Optionally restrict a key to specific source IPs / CIDR ranges (recommended for Enterprise).
Requests are rate limited per key; repeated invalid attempts are throttled per source IP.

Tools

search_contractsread-only

Search active SAM.gov contract opportunities.

query string? — Free-text across title and description.
naicsCode string? — Exact NAICS code.
setAside string? — Set-aside substring (e.g. 8(a), WOSB).
postedAfter string? — ISO date; only results posted on/after.
limit number? — 1–50, default 20.

get_contractread-only

Full detail of one active contract opportunity.

noticeId string — Required. The SAM.gov notice ID.

search_grantsread-only

Search active Grants.gov grant opportunities.

query string? — Free-text across title and description.
agency string? — Agency name substring.
status string? — Exact status (e.g. posted, closed).
closeBefore string? — ISO date; only grants closing on/before.
limit number? — 1–50, default 20.

get_grantread-only

Full detail of one active grant opportunity.

opportunityId string — Required. The Grants.gov opportunity ID.

All tools return active opportunities only and accept no account identifiers.

Roadmap

Planned capabilities — not yet available. Want early access? Mention it from the help center.

Usage metering

Planned

Per-key request analytics and metered billing — see call volume by tool, set budgets, and (for Enterprise) move from flat-tier access to usage-based pricing.

AI tools over MCP

Planned

Expose Kontrakk's AI features as MCP tools — NAICS detection and proposal/outreach email generation — so your assistant can draft directly against an opportunity.

Saved-workspace tools

Planned

Read your own saved contracts, watch list, pursuits, and grant checklists through MCP, scoped to your account.

OAuth 2.1 connection

Planned

One-click authorization for MCP clients that support it — no API key copying.

View plans

Quick start

On a Business or Enterprise plan, open Settings → Integrations and create an API key. Copy it — it is shown only once.

Add the server to your MCP client config with the key as a bearer token:

{ "mcpServers": { "kontrakk": { "url": "https://kontrakk.com/api/mcp", "headers": { "Authorization": "Bearer kk_live_your_key" } } } }

Authentication & security

Every request must send Authorization: Bearer <key>. The endpoint never uses session cookies.

Keys are opaque and stored only as a hash — the raw value is shown once at creation.

Keys expire after 90 days by default and can be rotated or revoked anytime from Settings.

Optionally restrict a key to specific source IPs / CIDR ranges (recommended for Enterprise).

Requests are rate limited per key; repeated invalid attempts are throttled per source IP.

Tools

search_contractsread-only

Search active SAM.gov contract opportunities.

query string? — Free-text across title and description.
naicsCode string? — Exact NAICS code.
setAside string? — Set-aside substring (e.g. 8(a), WOSB).
postedAfter string? — ISO date; only results posted on/after.
limit number? — 1–50, default 20.

get_contractread-only

Full detail of one active contract opportunity.

noticeId string — Required. The SAM.gov notice ID.

search_grantsread-only

Search active Grants.gov grant opportunities.

query string? — Free-text across title and description.
agency string? — Agency name substring.
status string? — Exact status (e.g. posted, closed).
closeBefore string? — ISO date; only grants closing on/before.
limit number? — 1–50, default 20.

get_grantread-only

Full detail of one active grant opportunity.

opportunityId string — Required. The Grants.gov opportunity ID.

All tools return active opportunities only and accept no account identifiers.

Roadmap

Planned capabilities — not yet available. Want early access? Mention it from the help center.

Usage metering

Planned

Per-key request analytics and metered billing — see call volume by tool, set budgets, and (for Enterprise) move from flat-tier access to usage-based pricing.

AI tools over MCP

Planned

Expose Kontrakk's AI features as MCP tools — NAICS detection and proposal/outreach email generation — so your assistant can draft directly against an opportunity.

Saved-workspace tools

Planned

Read your own saved contracts, watch list, pursuits, and grant checklists through MCP, scoped to your account.

OAuth 2.1 connection

Planned

One-click authorization for MCP clients that support it — no API key copying.