BidStackerBidStacker
ProductCompany MatchPricingAboutBlogHelp
Log inStart freearrow_forward
BidStackerBidStacker

Veteran-led and AI-native. We help capable small businesses find, write, team up on, and win federal contracts — without a big back office.

Product

  • How it works
  • Pricing
  • Company Match
  • SAM.gov registration
  • MCP integration
  • API

Company

  • About
  • Blog
  • Contact
  • Get started

Resources

  • Help center
  • API docs
  • MCP docs
  • Guides

Legal

  • Terms of service
  • Privacy policy

© 2026 BidStacker. All rights reserved.

TermsPrivacyContact

Agency names, seals, and logos are the property of their respective U.S. federal, state, and local government agencies and are used for identification purposes only; their use does not imply endorsement, sponsorship, or affiliation. BidStacker is a private marketplace and is not affiliated with the U.S. government.

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

VariableRequiredDescription
NEXT_PUBLIC_SUPABASE_URLYesSupabase project URL (validated at startup)
ANTHROPIC_API_KEYYesAnthropic API key for the AI generation tools
BIDSTACKER_PATPAT modeScoped personal access token (tenant-isolated; in PAT mode it determines the org for every tool)
BIDSTACKER_API_URLPAT modeBidStacker API base URL the PAT authenticates against (e.g. https://www.bidstacker.xyz)
SUPABASE_SERVICE_ROLE_KEYLocal onlyService-role key for the legacy single-tenant/local server — never use for hosted or multi-tenant deployments
SAM_GOV_API_KEYNoSAM.gov API key — needed by sync_federal
BIDSTACKER_DEFAULT_ORG_IDNoDefault org outside PAT mode (ignored in PAT mode, where the token scopes the org)
NEXT_PUBLIC_SUPABASE_ANON_KEYNoEnables the auth_login email/password tool
MCP_HTTP_PORTNoHTTP transport port (default 3100)
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