Connect the dots. Find the story.
Nonpartisan U.S. money-in-politics, congressional voting records, clause-by-clause bill text X-rays, lobbying disclosures, STOCK Act trades, and verifiable primary-source receipts for AI agents.
Developer Portal · Web App · Privacy Policy · Terms of Service
PQ-stringtheory/stringtheory-plugin is the official unified plugin and Model Context Protocol (MCP) package for StringTheory (https://theory.pqlabs.org/api/mcp).
A single repository powers seamless installation across Google Antigravity, Gemini CLI, Anthropic Claude Code & Claude Connectors, Cursor, OpenAI ChatGPT & Codex, and the Official MCP Registry (org.pqlabs/stringtheory) — bundling:
- Remote Streamable HTTP MCP Server (
https://theory.pqlabs.org/api/mcp) with 16 civic intelligence tools, Open Knowledge Format (ontology://) Civic Dictionary resources, and Google A2UI 1.0 (ui://stringtheory/*) interactive exhibits. - 4 High-Signal Agent Skills (
civic-research,money-to-vote-tracing,bill-xray,newsroom-receipt-verification) teaching strict primary-source citation discipline (FEC, Congress.gov, Senate LDA, STOCK Act PTRs) and correlation-vs-causation guardrails. - Dual Authentication:
- 1-Click OAuth 2.1 Sign-In (PKCE) — sign in directly in your browser when prompted by your IDE or AI client (includes Free
5 calls/dayinstantly, or inherits your paid plan). - Headless / CI API Keys (
Bearer st_live_...) — mint scoped keys at theory.pqlabs.org/developers for automated workflows, CLI agents, and team environments.
- 1-Click OAuth 2.1 Sign-In (PKCE) — sign in directly in your browser when prompted by your IDE or AI client (includes Free
Install directly from GitHub or the Antigravity Agent Marketplace:
agy plugin install PQ-stringtheory/stringtheory-plugin- OAuth 2.1 Sign-In: Click Sign in when prompted in Antigravity's Plugins Manager to connect your StringTheory account in one click.
- Optional API Key (
Bearer st_live_...): In~/.gemini/config/mcp_config.json:{ "mcpServers": { "stringtheory": { "serverUrl": "https://theory.pqlabs.org/api/mcp", "headers": { "Authorization": "Bearer st_live_YOUR_API_KEY" } } } }
Install as a Gemini CLI extension (bundles gemini-extension.json, GEMINI.md, and the remote MCP server):
gemini extensions install https://github.com/PQ-stringtheory/stringtheory-plugin- On first tool invocation, Gemini CLI launches the OAuth 2.1 browser flow automatically, or you can pass an
Authorization: Bearer st_live_...header in~/.gemini/settings.json.
claude plugin marketplace add PQ-stringtheory/stringtheory-plugin
claude plugin install stringtheory# Interactive OAuth 2.1 Sign-In
claude mcp add --transport http stringtheory https://theory.pqlabs.org/api/mcp
# Or with a headless st_live_... API key
claude mcp add --transport http stringtheory https://theory.pqlabs.org/api/mcp \
--header "Authorization: Bearer st_live_YOUR_API_KEY"- Open Settings -> Connectors -> Add Custom Connector.
- Enter URL:
https://theory.pqlabs.org/api/mcp - Complete the 1-click OAuth 2.1 Sign-In flow in your browser.
Install StringTheory from the Cursor Plugin Directory (.cursor-plugin/plugin.json), or add to .cursor/mcp.json:
{
"mcpServers": {
"stringtheory": {
"type": "http",
"url": "https://theory.pqlabs.org/api/mcp"
}
}
}- Cursor automatically discovers OAuth 2.1 on
https://theory.pqlabs.org/api/mcpand prompts Connect in MCP Settings. - For headless/key-based auth, add
"headers": { "Authorization": "Bearer st_live_YOUR_API_KEY" }.
- Open Settings -> Connectors -> Create (MCP Server).
- Set MCP Server URL to
https://theory.pqlabs.org/api/mcpand complete OAuth 2.1 sign-in.
Install from the Codex Plugin Directory (or download the .zip archive from GitHub Releases), or add directly to ~/.codex/config.toml:
[mcp_servers.stringtheory]
url = "https://theory.pqlabs.org/api/mcp"
# Optional for headless API key auth (omit to use interactive OAuth 2.1):
bearer_token_env_var = "STRINGTHEORY_API_KEY"Every billable tool call is metered flat at 1 call = 1 call — even multi-step research_stringtheory investigations. Protocol handshakes (initialize, tools/list, resources/list, resources/read, prompts/list) and submit_mcp_feedback cost 0 quota.
| Tool | Category | What It Does |
|---|---|---|
research_stringtheory |
Deep Research | Primary multi-step civic research engine across bills, clauses, roll-call votes, FEC Schedule A/B/E filings, 2-to-4 hop graph paths, and STOCK Act PTR trades with verified Cloud Spanner receipts, A2UI 1.0 surfaces, Social Share Studio cards (16:9 / 4:5 / 9:16), and 4-format Work Exports (article, policy_memo, legislation, report). |
ask_stringtheory |
Deep Research | Backward-compatible alias for research_stringtheory with identical live synthesis, citations, and Work Exports. |
resolve_entities |
Entity Resolution | Fuzzy-search and resolve lawmakers (bioguide_id), bills (bill_id), federal races (race_id), PACs/committees (committee_id), and 56 policy initiatives (initiative_slug) with canonical deep links. |
trace_connections |
Money & Graph | Bounded 2-to-4 hop Cloud Spanner PoliticalGraph path traversal (from + to) plus single-entity pre-vote STOCK Act PTR conflict tracing (t_trade < t_action) and 2-hop Donor -> Super PAC -> Candidate attribution. |
search_bill_clauses |
Legislation | Hybrid full-text + vector Reciprocal Rank Fusion search across bill_sections, committee_reports, and Congressional Record floor_speeches (CREC) with <DELETED> GPO XML blocks stripped automatically. |
xray_bill_and_amendments |
Legislation | Clause-by-clause bill X-ray classifying division/section policy mechanisms, mandates/prohibitions, buried omnibus riders (buried_riders_only), and 4-pattern Before vs. After floor amendment diffs. |
generate_arguments |
Legislation | Steelman Pro and Con legislative arguments anchored to exact statutory clauses, dollar amounts, roll-call votes, and swing-member coalition signals. |
get_politician_initiatives |
Accountability | Pre-materialized convictions across 56 policy initiatives, directional stance polarity (-1.0 to +1.0), Effort/Effectiveness/Bipartisanship grades, and peer lift (CONGRESS_119, CONGRESS_118, ROLLING_90D, ROLLING_365D, CAREER). |
inspect_race_and_outside_spending |
Campaign Finance | Reconciles candidate Form 3/3P fundraising with Super PAC Schedule E independent expenditures (periodic + 24/48-hour notices), Support vs. Oppose targeting, attack share, and outside-to-campaign ratios. |
trace_politician_accountability |
Accountability | Combines 6-driver roll-call vote forecast waterfalls with donor-vote deltas, donor-bill deltas, 2-hop Super PAC attribution, and pre-vote STOCK Act PTR conflict receipts (t_trade < t_vote). |
compare_members |
Voting Records | Head-to-head roll-call agreement rate, exact roll-call disagreements filtered by policy subject, and closest_allies (other_party bipartisan allies or all chamber peers). |
rank_and_trend_members |
Voting Records | Multi-Congress career trajectories (107th–119th Congress vs. peer_median), chamber/party leaderboards (party_breaks, party_loyalty, bipartisan_reach, missed_votes, bills_sponsored, became_law), and 10% outlier checks. |
trace_presidential_actions |
Executive Branch | Tracks presidential vetoes, pocket vetoes, executive orders, signed laws, and a lawmaker's veto-override roll-call votes (member_on_vetoes). |
verify_political_claim |
Fact-Checking | Audits political, voting, statutory, or campaign finance claims with arithmetic and record-identity checks, returning SUPPORTED, CONTRADICTED, or UNVERIFIED plus /r/... evidence receipts. |
find_story_leads |
Newsroom | Surfaces ranked investigative story leads across defectors, buried_riders, stock_conflicts, and dark_money over configurable time windows (24h, 7d, 30d, 119th). |
submit_mcp_feedback |
Feedback (Free) |
Sends bug reports, data quality notes, or feature requests directly to the StringTheory team at 0 quota cost. |
| Skill | Directory | Focus |
|---|---|---|
civic-research |
skills/civic-research/SKILL.md |
Entity resolution, multi-hop civic investigations, head-to-head member comparisons, multi-Congress career trends, presidential action tracking, and nonpartisan primary-source citation rules. |
money-to-vote-tracing |
skills/money-to-vote-tracing/SKILL.md |
Following campaign contributions, 2-hop Super PAC independent expenditures, lobbying filings, and pre-vote STOCK Act trades (t_trade < t_action) to roll-call votes — strictly separating statistical association/sequence from unproven quid-pro-quo causation. |
bill-xray |
skills/bill-xray/SKILL.md |
Clause-level statutory text search, <DELETED>-clean GPO parsing, buried omnibus rider detection, 4-pattern floor amendment diffs, and steelman Pro/Con impact analysis. |
newsroom-receipt-verification |
skills/newsroom-receipt-verification/SKILL.md |
Atomic fact-checking of political claims, FEC/roll-call arithmetic verification, and evidence-backed investigative lead discovery. |
Manage your OAuth connections, st_live_... API keys, and usage at theory.pqlabs.org/developers.
| Tier / Pack | Included Allowance | Auth Methods | Notes |
|---|---|---|---|
| Free | 5 calls / day |
OAuth 2.1 Sign-In | Instant zero-key trial across Claude, Cursor, ChatGPT, Codex, Gemini CLI, and Antigravity |
| Pro | 1,000 calls / month |
OAuth 2.1 + st_live_... API keys |
Flat 1 call = 1 call metering across all 15 billable tools |
| Builder | 5,000 calls / month |
OAuth 2.1 + st_live_... API keys |
Ideal for daily agentic workflows, civic apps, and policy analysts |
| Scale | 20,000 calls / month |
OAuth 2.1 + st_live_... API keys |
Built for newsrooms, research desks, and high-throughput pipelines |
mcp_2k_pack |
+2,000 calls / pack |
Automatically drawn down after base quota | Top-up add-on pack (submit_mcp_feedback, ontology://, and ui:// reads are always 0 cost) |
stringtheory-plugin/
├── assets/logo.png # 512x512 StringTheory 3-node civic mark
├── skills/
│ ├── civic-research/SKILL.md
│ ├── money-to-vote-tracing/SKILL.md
│ ├── bill-xray/SKILL.md
│ └── newsroom-receipt-verification/SKILL.md
├── plugin.json # Google Antigravity root manifest
├── .antigravity-plugin/plugin.json # Google Antigravity scoped manifest
├── mcp_config.json # Google Antigravity MCP server config
├── gemini-extension.json # Gemini CLI extension manifest
├── GEMINI.md # Gemini CLI context & citation rules
├── .cursor-plugin/plugin.json # Cursor Marketplace manifest
├── mcp.json # Cursor MCP server config
├── .claude-plugin/
│ ├── plugin.json # Anthropic Claude Code plugin manifest
│ └── marketplace.json # Anthropic Claude Code marketplace catalog
├── .codex-plugin/plugin.json # OpenAI ChatGPT & Codex plugin manifest
├── .mcp.json # Claude Code & OpenAI Codex MCP server config
├── server.json # Official MCP Registry (org.pqlabs/stringtheory)
└── LICENSE # Apache-2.0
- Developer Portal & API Keys: https://theory.pqlabs.org/developers
- StringTheory Web App: https://theory.pqlabs.org
- Privacy Policy: https://theory.pqlabs.org/privacy
- Terms of Service: https://theory.pqlabs.org/terms
- Support: support@pqlabs.org (or ask your agent to call
submit_mcp_feedbackfor free!)
Licensed under the Apache License 2.0.
