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:

{
  "mcpServers": {
    "bidstacker": {
      "command": "node",
      "args": ["packages/mcp-server/dist/bin/bidstacker-mcp.js"],
      "env": {
        "NEXT_PUBLIC_SUPABASE_URL": "your-supabase-url",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key",
        "ANTHROPIC_API_KEY": "your-anthropic-key"
      }
    }
  }
}

3. HTTP Transport (Optional)

For web-based integrations, run the HTTP server:

node packages/mcp-server/dist/bin/bidstacker-mcp-http.js
# Listens on port 3100

keyEnvironment Variables

NEXT_PUBLIC_SUPABASE_URLRequired

Supabase project URL

SUPABASE_SERVICE_ROLE_KEYRequired

Service role key (bypasses RLS)

ANTHROPIC_API_KEYRequired

For AI generation and matching

SAM_GOV_API_KEYOptional

For federal sync (SAM.gov)

BIDSTACKER_DEFAULT_ORG_IDOptional

Default org for tools that need one

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