MCP Integration

Connect BidStacker to Claude Desktop, Claude Code, or any MCP-compatible AI agent for hands-free proposal management.

infoWhat is MCP?

The Model Context Protocol (MCP) is a standard for giving AI agents access to external tools and data. BidStacker's MCP server exposes 29 tools that let AI agents search RFPs, create proposals, run compliance checks, and more — all through natural language.

buildSetup

1. Install the MCP Server

# Clone and build
cd packages/mcp-server
npm install
npm run build

2. Configure for Claude Code

Create a .mcp.json in your project root and authenticate with a scoped personal access token (PAT):

{
  "mcpServers": {
    "bidstacker": {
      "command": "node",
      "args": ["packages/mcp-server/dist/bin/bidstacker-mcp.js"],
      "env": {
        "NEXT_PUBLIC_SUPABASE_URL": "https://YOUR_PROJECT.supabase.co",
        "ANTHROPIC_API_KEY": "sk-ant-YOUR_KEY",
        "BIDSTACKER_API_URL": "https://www.bidstacker.xyz",
        "BIDSTACKER_PAT": "pat_YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}
lock

Authenticate with a scoped personal access token (sent as Authorization: Bearer pat_...), never a Supabase service-role key. Scoped tokens are tenant-isolated and respect row-level security. Create and manage tokens under Settings → Integrations.

3. HTTP Transport (Optional)

For web-based integrations, run the HTTP server. Every /mcp request must carry an Authorization: Bearer pat_... header — unauthenticated requests are rejected with 401.

node packages/mcp-server/dist/bin/bidstacker-mcp-http.js
# Listens on port 3100 (override with MCP_HTTP_PORT)

keyEnvironment Variables

NEXT_PUBLIC_SUPABASE_URLRequired

Supabase project URL (validated at startup)

ANTHROPIC_API_KEYRequired

Anthropic API key for the AI generation tools

BIDSTACKER_PATPAT mode

Scoped personal access token (tenant-isolated; in PAT mode it determines the org for every tool)

BIDSTACKER_API_URLPAT mode

BidStacker API base URL the PAT authenticates against (e.g. https://www.bidstacker.xyz)

SUPABASE_SERVICE_ROLE_KEYLocal only

Service-role key for the legacy single-tenant/local server — never use for hosted or multi-tenant deployments

SAM_GOV_API_KEYOptional

SAM.gov API key — needed by sync_federal

BIDSTACKER_DEFAULT_ORG_IDOptional

Default org outside PAT mode (ignored in PAT mode, where the token scopes the org)

NEXT_PUBLIC_SUPABASE_ANON_KEYOptional

Enables the auth_login email/password tool

MCP_HTTP_PORTOptional

HTTP transport port (default 3100)

constructionAvailable Tools (29)

build
search_rfps

Search RFPs by keyword, state, agency, NAICS, set-aside, deadline, or match score

build
get_rfp

Get full details of a specific RFP

build
get_rfp_classification

Get AI classification breakdown (NAICS sectors, keywords, categories)

build
get_matches

Get top RFP matches for your organization sorted by score

build
score_rfp_for_org

Calculate or recalculate match score for a specific RFP

build
list_proposals

List proposals filtered by status or linked RFP

build
get_proposal

Get full proposal details including all sections

build
create_proposal

Create a new proposal, optionally from a template

build
update_proposal_section

Update a section title and/or body

build
add_proposal_section

Add a new section at a specific position

build
set_proposal_status

Change proposal status (draft/review/submitted/awarded/lost)

build
get_organization

Get organization profile including capabilities and matching framework

build
update_organization

Update organization profile fields

build
generate_matching_framework

Use AI to generate an optimized matching framework

build
generate_proposal_draft

Generate content for all empty sections in a proposal

build
generate_section

Generate content for a single proposal section

build
ai_improve

Improve, shorten, expand, or summarize text

build
run_compliance_check

Run compliance analysis on a proposal

build
list_templates

List available proposal templates

build
get_template

Get template details including sections

build
apply_template

Apply a template to an existing proposal

build
sync_federal

Sync federal opportunities from SAM.gov

build
sync_state

Sync state/local government opportunities

build
get_sync_status

Get recent sync history and statistics

build
list_reference_docs

List reference documents for your organization

build
get_reference_doc

Get a reference document with content

build
create_reference_doc

Create a new reference document

build
delete_reference_doc

Delete a reference document

build
find_and_generate

Find best matches and optionally auto-generate a proposal

play_circleExample Workflows

Find and Bid on Contracts

1. search_rfps — Find matching opportunities

2. get_rfp — Review full details

3. create_proposal — Start a proposal from template

4. generate_proposal_draft — AI-generate all sections

5. run_compliance_check — Verify compliance

One-Click Bid (Composite)

Use find_and_generate with auto_generate: true to find the top match and automatically create a full proposal draft in one step.

linkRelated Resources

api
REST API Reference
15+ endpoints for programmatic access to BidStacker features
settings
Integration Settings
Manage your API keys and integration connections