Skip to content

profile: publish the tool index and source the data claims #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
stxkxs merged 1 commit into from
Aug 19, 2026
Merged

profile: publish the tool index and source the data claims #4

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 79 additions & 17 deletions profile/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,31 +33,93 @@ can re-fetch yourself.

## The data

Primary sources only. Public-domain US federal records, refreshed nightly from
the source of record — never an aggregator.
Primary sources only. Public-domain US federal records, ingested nightly from the
source of record — never an aggregator. What each nightly run *finds* depends on
the upstream's own cadence, so coverage is stated per source rather than as one
number:

- **FEC** — campaign finance: 217M+ itemized contribution records across the
2020–2026 cycles, plus committees and candidates
- **USASpending** — federal awards and contracts, keyed on recipient UEI
- **SAM.gov** — contract opportunities and solicitations
- **Grants.gov** — grant opportunities
2020–2026 cycles, plus committees and candidates. FEC publishes bulk files on
the two-year election cycle, so the ingest advances when new files land rather
than daily.
- **USASpending** — federal awards and contracts, keyed on recipient UEI. New
records land daily.
- **SAM.gov** — contract opportunities and solicitations. New records land daily.
- **Grants.gov** — grant opportunities. Advances when the upstream publishes.

No date is printed here on purpose. Every answer carries its own `retrieved_at`
(when citature fetched the record) alongside the source's own `as_of` date, which
is a separate field — a receipt on the answer beats an as-of line on a page that
nobody regenerates.

## The tools

Delivered on the [Apify Store](https://apify.com/citature).

- **Money** — FEC contributions by state and committee type, federal awards by
agency/state/recipient, follow-the-money committee inflows, and funding-entity
lookup and search
- **GovCon** — expiring-contract recompetes by NAICS with incumbent UEI,
contractor award lineage by agency, and agency buying patterns by year
- **MCP** — every tool above delivered as agent-native calls from one MCP server
Fourteen tools in two families, all live. Each is callable from the MCP server or
as a standalone [Apify actor](https://apify.com/citature). The mapping is not
one-to-one — several tools share an actor, and `opportunity_search` spans both
SAM.gov and Grants.gov.

Descriptions below are the tool descriptions as registered, so an agent reading
this page and an agent reading the server see the same contract.

### Money

| Tool | Contract |
| --- | --- |
| `contributions_by_state` | Individual FEC contribution dollars for an election cycle, totaled by the contributor's state of origin, largest first. |
| `contributions_by_committee_type` | Individual FEC contribution dollars for an election cycle, totaled by the recipient committee's type, largest first. |
| `awards_by_agency` | Federal contract-award dollars for a fiscal year, ranked by the awarding agency. Declares the exact agency crosswalk in the receipt. |
| `awards_by_state` | Federal contract-award dollars for a fiscal year, ranked by place-of-performance state (a native award field, no join). |
| `awards_by_recipient` | Federal contract-award dollars for a fiscal year, ranked by recipient keyed on the universal federal awardee UEI. Declares the UEI crosswalk. |
| `follow_the_money` | Itemized contribution dollars flowing into an FEC committee, aggregated by the contributor's state of origin. Entity-level only; declares the committee-id crosswalk. |
| `committee_lookup` | Look up one FEC committee by its committee id. Returns the committee or a null answer with a citation when none is found. |
| `candidate_lookup` | Look up one FEC candidate by its candidate id. Returns the candidate or a null answer with a citation when none is found. |
| `committee_search` | Prefix-search FEC committees by name (case-insensitive, bounded). Each result carries the citature entity id next to the FEC id. |
| `candidate_search` | Prefix-search FEC candidates by name (case-insensitive, bounded). Each result carries the citature entity id next to the FEC id. |

### GovCon

| Tool | Contract |
| --- | --- |
| `recompetes_expiring` | Federal contracts whose period of performance ends within a YYYY-MM month window, soonest first, each with the incumbent (by UEI) and its obligation. Optional NAICS (prefix) and awarding-agency (name) filters. Declares the exact UEI and agency-code crosswalks. |
| `incumbent_history` | A federal contractor's contract lineage per agency and NAICS, by exact UEI or recipient-name prefix (at least one required): contract count, total obligated, fiscal-year span, latest period-of-performance end. Declares the exact UEI and agency-code crosswalks. |
| `agency_buying` | Federal contract obligations, contract counts, and distinct-contractor counts by awarding agency, NAICS, and fiscal year. All filters optional. Declares the exact agency-code crosswalk and the UEI behind the distinct-contractor count. |
| `opportunity_search` | Open and forecasted procurement opportunities across SAM.gov and Grants.gov, newest first, filterable by NAICS, agency, posted-date window, and active state. Single-source native records, so no cross-source join; cites each contributing source. |

### Actors

| Actor | Family |
| --- | --- |
| [`funding-entity-lookup`](https://apify.com/citature/funding-entity-lookup) | money |
| [`fec-contributions`](https://apify.com/citature/fec-contributions) | money |
| [`federal-awards`](https://apify.com/citature/federal-awards) | money |
| [`follow-the-money`](https://apify.com/citature/follow-the-money) | money |
| [`govcon-recompetes`](https://apify.com/citature/govcon-recompetes) | govcon |
| [`incumbent-history`](https://apify.com/citature/incumbent-history) | govcon |
| [`agency-buying-patterns`](https://apify.com/citature/agency-buying-patterns) | govcon |
| [`citature-mcp`](https://apify.com/citature/citature-mcp) | mcp |

Every tool above is delivered as agent-native calls from one MCP server,
published as the [`citature-mcp`](https://apify.com/citature/citature-mcp) actor
and served over Streamable HTTP on the `/mcp` path.

The connection host is assigned by the Apify platform when the actor starts in
Standby mode, so it is not a fixed address this page can quote — take it from the
actor's listing. Nothing here states an endpoint it cannot cite.

## The rules

Research over public records — never legal, financial, or eligibility advice.
Entity-level data only; no individual-person products. citature reports what the
record says and never renders a verdict.
The standing caveats, quoted from the literals every receipt and every tool
description ships:

- Research over public-domain federal records — not legal, financial, or
eligibility advice.
- citature reports what the record says. It never renders a compliance verdict,
a screening pass/fail, or a recommendation.
- Entity-level records only (committees, candidates, recipients, agencies,
contracts). No individual-person data.

Money is integer cents.

---

Expand Down
Loading