Awardopedia - Federal Contracts

io.github.grayson-sysPublished by GitHub account grayson-sysv0.1.1Updated Nov 3, 2026

Search federal government contract opportunities from SAM.gov via Claude

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Searches U.S. federal contract opportunities and award data from SAM.gov and USASpending.gov, letting an assistant look up government contracts.

What you can do
  • Search federal contract opportunities sourced from SAM.gov
  • Look up federal contract award data drawn from USASpending.gov
  • Browse and filter contract records through the hosted Awardopedia service
When to use it
Useful when you want an assistant to find or summarize U.S. federal contract opportunities and award records without leaving the chat, for example for market research or bid prospecting.
Requirements
Runs locally via npx (Node.js required) and connects to the hosted Awardopedia service. Requires a free API key supplied in the AWARDOPEDIA_API_KEY environment variable, obtained by signing up on the provider's site. Desktop client only.
Before you install
The API key is a secret passed by environment variable; keep it out of shared configs. The README notes that AI contract analysis is billed in paid credit packs, so paid features may incur charges. Contract data is sent to the provider's hosted service.

Installation

In SourceWeft

  1. Open Awardopedia - Federal Contracts in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
# Clonegit clone https://github.com/openclaw/awardopedia.gitcd awardopedia
# Databasepsql -d your_db -f scripts/schema.sql
# APIcd apicp ../.env.example .env   # Edit with your valuesnpm installnpm run dev               # Starts on :3001
# Frontend (separate terminal)cd webnpm installnpm 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/awardopediaJWT_SECRET=any-dev-secretPORT=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).

Source: README.md at commit 159e4bb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.