English Français العربية

Awardopedia - Federal Contracts

Official registry Government and legal

Search federal government contract opportunities from SAM.gov via Claude

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package awardopedia-mcp
Claude Code 
claude mcp add awardopedia-federal-contracts -e 'AWARDOPEDIA_API_KEY=<your awardopedia_api_key>' -- npx -y awardopedia-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "awardopedia-federal-contracts": {
            "command": "npx",
            "args": [
                "-y",
                "awardopedia-mcp@0.1.1"
            ],
            "env": {
                "AWARDOPEDIA_API_KEY": "<your awardopedia_api_key>"
            }
        }
    }
}

Environment variables

  • AWARDOPEDIA_API_KEY required secret Free API key from awardopedia.com/signup

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Awardopedia
  2. Tech Stack
  3. Local Development
  4. Project Structure
  5. Data
  6. Business Model
  7. License

Awardopedia

Free, searchable interface for U.S. federal contract award data sourced from USASpending.gov.

Tech Stack

  • Frontend: React 18 + Vite 5, react-router-dom v6, Chart.js, lucide-react
  • Backend: Node.js 20 + Express 4, PostgreSQL 15
  • AI: Anthropic Claude API for contract analysis (paid credits)
  • Payments: Stripe Checkout for credit packs
  • Auth: Magic link email via SendGrid + JWT
  • Hosting: DigitalOcean App Platform
  • DNS/CDN: Cloudflare

Local Development

Prerequisites
  • Node.js 20+
  • PostgreSQL 15+
  • Python 3.10+ (for data sync scripts)
Setup
# Clone
git clone https://github.com/openclaw/awardopedia.git
cd awardopedia

# Database
psql -d your_db -f scripts/schema.sql

# API
cd api
cp ../.env.example .env   # Edit with your values
npm install
npm run dev               # Starts on :3001

# Frontend (separate terminal)
cd web
npm install
npm run dev               # Starts on :3000, proxies /api to :3001
Environment Variables

See .env.example for all required variables. At minimum for local dev:

DATABASE_URL=postgresql://localhost:5432/awardopedia
JWT_SECRET=any-dev-secret
PORT=3001

Project Structure

awardopedia/
├── api/                  # Express API server
│   ├── src/
│   │   ├── db/           # Database connection + queries
│   │   ├── middleware/    # Auth, credits, rate limiting
│   │   ├── routes/       # API route handlers
│   │   └── services/     # Claude AI, Stripe, SendGrid
│   └── Dockerfile
├── web/                  # React + Vite frontend
│   ├── src/
│   │   ├── components/   # Reusable UI components
│   │   ├── pages/        # Route pages
│   │   ├── styles/       # CSS tokens, global, components
│   │   └── utils/        # API client, formatters, SEO
│   └── public/
├── scripts/
│   ├── schema.sql        # PostgreSQL schema
│   ├── ingest.py         # Bulk CSV ingestion
│   └── sync.py           # Weekly USASpending API sync
├── docs/
│   ├── api.md            # API endpoint reference
│   ├── data-model.md     # Database schema docs
│   └── deployment.md     # Deployment guide
└── assets/               # Brand logos

Data

All contract data is sourced from USASpending.gov, the official open data source of federal spending information maintained by the U.S. Department of the Treasury as mandated by FFATA.

  • Bulk import: python3 scripts/ingest.py --file contracts.csv
  • Weekly sync: python3 scripts/sync.py (fetches last 7 days from USASpending API)

Business Model

  • Core data access (search, filter, browse): Free
  • AI analysis (contract insights, summaries): Paid credits
    • Starter: 100 credits / $9
    • Pro: 500 credits / $29
    • Power: 2,000 credits / $79

License

Proprietary. Data sourced from USASpending.gov (public domain).

Frequently asked questions

What is Awardopedia - Federal Contracts?

Search federal government contract opportunities from SAM.gov via Claude

How do I install Awardopedia - Federal Contracts?

It runs on your machine. In Claude Code: claude mcp add awardopedia-federal-contracts -e 'AWARDOPEDIA_API_KEY=<your awardopedia_api_key>' -- npx -y awardopedia-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Awardopedia - Federal Contracts need an API key?

Yes. It expects AWARDOPEDIA_API_KEY, which you set in its configuration.

Is Awardopedia - Federal Contracts open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Awardopedia - Federal Contracts?

It is published by grayson-sys. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.