Server definition

Hash: sha256:22e63ecff55619d1ae2a7c85600cc85e239eede86dd63b886df8b1eb99963b99
What it is: What a remote MCP server returned when asked what it offers: 24 tools

The blob, as servednamed by its sha256

{
  "instructions": "HillSignal answers questions about the U.S. federal government and the market from the public record: contract awards, what agencies are about to buy, congressional stock trades and board seats, PAC and super PAC money, insider trades, private raises, bills and executive orders, themes, and its own verified track record. Companies are matched to tickers by exact match only; a miss is reported as a miss. Every row carries a source URL and a date. Cite the URLs. Start with resolve_entity or get_entity for a company, get_politician for a member of Congress, search_awards for specific contracts and award_totals for \"who won the most\" questions (it counts every match), search_opportunities for upcoming purchases, latest_events for what just happened. Money questions: money_trail for one donor (\"how much did Musk give\"), super_pacs for the biggest super PACs or one committee's donors and spending, outside_money for who is spending for or against a candidate, pac_lookup and pac_totals for corporate PACs. search_awards returns total_matching; page with offset when it exceeds what was returned.",
  "tools": [
    {
      "description": "Aggregate every matching federal award (same filters as search_awards) into totals per recipient, per resolved ticker, or per awarding agency: award count, total dollars, share, first and last award, largest award. Use this for \"who won the most from the Navy this year\" and similar questions; it counts all matches, not a page.",
      "inputSchema": {
        "properties": {
          "agency": {
            "description": "Awarding agency or sub-agency (partial)",
            "type": "string"
          },
          "group_by": {
            "description": "recipient (default) | ticker | agency",
            "type": "string"
          },
          "keyword": {
            "description": "Word in the award description",
            "type": "string"
          },
          "limit": {
            "description": "Top groups to return, 1-50 (default 25)",
            "type": "number"
          },
          "min_amount": {
            "description": "Minimum award amount in USD",
            "type": "number"
          },
          "recipient": {
            "description": "Recipient or parent name (partial)",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          },
          "ticker": {
            "description": "Resolved ticker",
            "type": "string"
          },
          "until": {
            "description": "ISO date; only rows on or before this date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "award_totals",
      "outputSchema": null
    },
    {
      "description": "Stock trades disclosed by members of Congress (House and Senate Periodic Transaction Reports), by member name, ticker, transaction type or date. Returns one row per transaction with the disclosed amount range and the filing PDF. limit caps the FILINGS read, not the trades returned, and filings_matching is how many exist: when truncated is set, far more trades exist than are shown and returned_trades must never be quoted as a total.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "politician": {
            "description": "Member name (partial)",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          },
          "ticker": {
            "description": "Ticker traded",
            "type": "string"
          },
          "transaction_type": {
            "description": "purchase | sale",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "congressional_trades",
      "outputSchema": null
    },
    {
      "description": "Row counts and the latest dated row for every dataset behind these tools, plus entity-resolution coverage. Call it when an answer depends on how complete the data is, or before saying something does not exist.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "data_coverage",
      "outputSchema": null
    },
    {
      "description": "Executive orders, proclamations and memoranda with affected sectors and tickers.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "query": {
            "description": "Words in the title or summary",
            "type": "string"
          },
          "sector": {
            "description": "Sector label",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "executive_orders",
      "outputSchema": null
    },
    {
      "description": "Who is paid to represent a foreign government or party inside the United States, and HOW MUCH, from the Justice Department's FARA register and the contracts filed with it. Pass top=\"contracts\" for the biggest deals — the largest contract prices, who pays whom, and who owns the client in the filer's own sworn words. Pass country= to LIST THAT COUNTRY'S AGENTS BY NAME: registered_agents is the full current roster, each with its foreign principal, registration number and dates, plus former_agents and the counts. Answer \"how many agents does Israel have and who are they\" from that roster. Pass bill= for the foreign interests that lobbied a bill, or nothing for the country leaderboard. A country response also carries also_in_lobbying_data, the minority of those agents that additionally file under the Lobbying Disclosure Act, split into DIRECT, where the lobbying client IS the foreign principal and bills are named, and SHARED_FIRM, where one firm holds a foreign registration and separate domestic clients — context, never a claim about those clients. That subset is never the roster. Countries are spelled as the register spells them. A country roster also carries the MONEY per agent: agreed_price is the contract price from the agreement exhibit filed at registration, always with the rate it is stated at, and reported_receipts is what the agent later reported actually receiving, as a floor rather than earnings. Both are null where no figure could be proved. Each agent may also carry foreign_principal_owned_by — the filer's sworn words on who owns the foreign principal, which is how a US-registered company names its foreign parent.",
      "inputSchema": {
        "properties": {
          "bill": {
            "description": "Bill number, e.g. HR1234 — returns foreign principals that lobbied it",
            "type": "string"
          },
          "country": {
            "description": "Country as the register spells it, e.g. \"ISRAEL\", \"SAUDI ARABIA\", \"KOREA, SOUTH\"",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-100 (default 20)",
            "type": "number"
          },
          "rate": {
            "description": "With top=contracts: the rate to rank, \"month\" (default) or \"year\", \"quarter\", \"hour\", \"one-time\". Rates are never mixed or converted.",
            "type": "string"
          },
          "top": {
            "description": "Pass \"contracts\" to rank the BIGGEST foreign-agent contract prices on file — who is paid the most, by whom. Combine with country= to narrow it.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "foreign_agents",
      "outputSchema": null
    },
    {
      "description": "SEC Form D private placements by issuer name, resolved ticker, date or minimum amount. No minimum size is applied: pass min_amount to impose one. A null offering_amount means the filer stated no offering size, which Form D permits, and is not a raise of zero.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "min_amount": {
            "description": "Minimum offering amount USD",
            "type": "number"
          },
          "query": {
            "description": "Issuer name (partial)",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          },
          "ticker": {
            "description": "Resolved public parent ticker",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "form_d_raises",
      "outputSchema": null
    },
    {
      "description": "One company in the federal record: contracts won, PACs, patents, private raises, members of Congress who hold board seats there, insider trades, and its connections graph. Look up by ticker, entity_id, or a name (resolved exactly).",
      "inputSchema": {
        "properties": {
          "entity_id": {
            "description": "HillSignal entity id (hs:entity:...)",
            "type": "string"
          },
          "name": {
            "description": "Company name; resolved by exact match",
            "type": "string"
          },
          "ticker": {
            "description": "Stock ticker, e.g. LMT",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_entity",
      "outputSchema": null
    },
    {
      "description": "A member of Congress: committees, board seats and other positions from annual Financial Disclosures (with resolved tickers), recent stock trades, and top PAC contributors from FEC data. Look up by name or bioguide_id; ambiguous names return candidates.",
      "inputSchema": {
        "properties": {
          "bioguide_id": {
            "description": "Bioguide id, e.g. P000197",
            "type": "string"
          },
          "name": {
            "description": "Member name",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_politician",
      "outputSchema": null
    },
    {
      "description": "One theme in full: the setup, the dated chronology with each beat linked to its source record, why it matters, what to watch, and the evidence.",
      "inputSchema": {
        "properties": {
          "theme_id": {
            "description": "Theme id from list_themes (with or without hs:theme: prefix)",
            "type": "string"
          }
        },
        "required": [
          "theme_id"
        ],
        "type": "object"
      },
      "name": "get_theme",
      "outputSchema": null
    },
    {
      "description": "SEC Form 4 insider transactions by ticker or insider name; filter to buys or sells, minimum value, date.",
      "inputSchema": {
        "properties": {
          "insider": {
            "description": "Insider name (partial)",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "min_value": {
            "description": "Minimum total value USD",
            "type": "number"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          },
          "ticker": {
            "description": "Ticker",
            "type": "string"
          },
          "type": {
            "description": "buy | sell",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "insider_trades",
      "outputSchema": null
    },
    {
      "description": "Largest institutional holders of a ticker from 13F-HR filings HillSignal has ingested, latest position per institution.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "ticker": {
            "description": "Ticker",
            "type": "string"
          }
        },
        "required": [
          "ticker"
        ],
        "type": "object"
      },
      "name": "institutional_holders",
      "outputSchema": null
    },
    {
      "description": "The newest events across every source (awards, trades, filings, bills, orders, themes), with provenance. Optional filters by category, ticker or source id.",
      "inputSchema": {
        "properties": {
          "categories": {
            "description": "Comma-separated categories, e.g. contract,trade,filing",
            "type": "string"
          },
          "limit": {
            "description": "Max events, 1-25 (default 20)",
            "type": "number"
          },
          "sources": {
            "description": "Comma-separated source ids from /api/wire",
            "type": "string"
          },
          "tickers": {
            "description": "Comma-separated tickers",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "latest_events",
      "outputSchema": null
    },
    {
      "description": "The themes the government is currently funding across bills, contracts, solicitations and filings, each with a permanent page and a verdict.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_themes",
      "outputSchema": null
    },
    {
      "description": "Senate LDA lobbying disclosures: what a company spent lobbying, which firms it hired, which issues it worked, which agencies it contacted, which bills it named, and how many of its lobbyists previously held government posts. Or pass bill= for everyone who lobbied a given bill. This is the intent layer — super PAC money says who a company is FOR, lobbying says what it WANTS. Answers \"what is Coinbase lobbying on\", \"who lobbied HR1234\", \"which agencies does Lockheed contact\".",
      "inputSchema": {
        "properties": {
          "bill": {
            "description": "Bill number, e.g. HR1234 or S.567 — returns everyone who lobbied it",
            "type": "string"
          },
          "company": {
            "description": "Company name; resolved by exact match",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-50 (default 20)",
            "type": "number"
          },
          "since_year": {
            "description": "Only filings from this year onward",
            "type": "number"
          },
          "ticker": {
            "description": "Issuer ticker, e.g. COIN",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "lobbying",
      "outputSchema": null
    },
    {
      "description": "How much a person or organization gave, through which entities, to which committees, and what those committees did with it. Answers \"how much did Elon Musk give to Trump\", \"who did Timothy Mellon fund\", \"where did Uline's money go\". Returns donor_identity (the resolved person or organization, every employer spelling folded into one, with lifetime totals), given_via (the LLCs, trusts and partnerships the cheques were actually written under — how the money reached the committee), the recipient committees, and each super PAC's independent spending for and against candidates. Names go in as written (\"Elon Musk\"); the FEC form (\"MUSK, ELON\") is handled. Ambiguous names return matched_as; narrow with employer.",
      "inputSchema": {
        "properties": {
          "cycle": {
            "description": "Two-year election cycle, e.g. 2024 or 2026; omit for current and previous",
            "type": "number"
          },
          "employer": {
            "description": "Narrow to receipts whose employer field contains this (e.g. \"Tesla\")",
            "type": "string"
          },
          "limit": {
            "description": "Max recipient committees, 1-25 (default 10)",
            "type": "number"
          },
          "name": {
            "description": "Donor: a person (\"Ken Griffin\") or organization (\"Uline\")",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "money_trail",
      "outputSchema": null
    },
    {
      "description": "Outside money on a candidate: every super PAC and other filer spending independently to support or oppose them, with totals, from FEC Schedule E. Answers \"who is backing Trump\", \"which groups are attacking this senator\", \"how much outside money is in the Ohio Senate race\". Candidate names go in as written.",
      "inputSchema": {
        "properties": {
          "candidate": {
            "description": "Candidate name, e.g. \"Donald Trump\", \"Ossoff\"",
            "type": "string"
          },
          "cycle": {
            "description": "Two-year election cycle, e.g. 2024 or 2026; omit for all",
            "type": "number"
          },
          "limit": {
            "description": "Max committees per side, 1-50 (default 15)",
            "type": "number"
          }
        },
        "required": [
          "candidate"
        ],
        "type": "object"
      },
      "name": "outside_money",
      "outputSchema": null
    },
    {
      "description": "Corporate and trade-association PACs linked to a public company (by ticker) or found by committee name, with the candidates they fund. Answers \"does Lockheed have a PAC and who does it give to\", \"which politicians take money from Pfizer's PAC\". For super PACs and mega-donors use super_pacs and money_trail instead.",
      "inputSchema": {
        "properties": {
          "committee_name": {
            "description": "PAC or sponsor name (partial)",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "ticker": {
            "description": "Issuer ticker",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "pac_lookup",
      "outputSchema": null
    },
    {
      "description": "Which PACs give the most: contributors to tracked candidates ranked by total dollars (FEC Schedule A), by election cycle, with donor-processing conduits like ActBlue and WinRed separated out. mode=disbursers ranks committees by their own reported disbursements instead. Use for \"which PACs donate the most to Congress\" questions; for super PACs use super_pacs.",
      "inputSchema": {
        "properties": {
          "cycle": {
            "description": "Two-year election cycle, e.g. 2026 or 2024; omit for all",
            "type": "number"
          },
          "limit": {
            "description": "Top rows, 1-50 (default 10)",
            "type": "number"
          },
          "mode": {
            "description": "contributors (default) | disbursers",
            "type": "string"
          },
          "query": {
            "description": "Filter contributor or committee name (partial)",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "pac_totals",
      "outputSchema": null
    },
    {
      "description": "Map an organization name (a contract recipient, a subsidiary, a PAC sponsor, a Form D issuer) to its public-company ticker. Exact normalized match against SEC legal names, aliases and the Exhibit 21 subsidiary map; returns the method and a confidence, or the reason for a miss. Never guesses.",
      "inputSchema": {
        "properties": {
          "name": {
            "description": "Organization name as written",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "resolve_entity",
      "outputSchema": null
    },
    {
      "description": "Search federal contract awards (USAspending, $10M+) by recipient, ticker, awarding agency, keyword, date range or minimum amount. Returns total_matching and pages with offset (up to 50 per call), sorted by date or amount. For \"who won the most\" questions use award_totals instead, which counts every match.",
      "inputSchema": {
        "properties": {
          "agency": {
            "description": "Awarding agency or sub-agency (partial), e.g. \"Navy\"",
            "type": "string"
          },
          "keyword": {
            "description": "Word in the award description or NAICS description",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-50 (default 25)",
            "type": "number"
          },
          "min_amount": {
            "description": "Minimum award amount in USD",
            "type": "number"
          },
          "offset": {
            "description": "Row offset for paging (default 0)",
            "type": "number"
          },
          "recipient": {
            "description": "Recipient or parent name (partial)",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          },
          "sort": {
            "description": "date (default) | amount",
            "type": "string"
          },
          "ticker": {
            "description": "Resolved ticker",
            "type": "string"
          },
          "until": {
            "description": "ISO date; only rows on or before this date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_awards",
      "outputSchema": null
    },
    {
      "description": "Full-text search over bills, contract awards and other government events with their analysed sector and ticker exposure. Filter by bill number, ticker, sector, date or event type.",
      "inputSchema": {
        "properties": {
          "bill_number": {
            "description": "e.g. HR1234 or S567",
            "type": "string"
          },
          "event_type": {
            "description": "Comma-separated event types",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "query": {
            "description": "Search words",
            "type": "string"
          },
          "sector": {
            "description": "Sector label, e.g. Defense",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          },
          "ticker": {
            "description": "Ticker named in the analysis",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_bills",
      "outputSchema": null
    },
    {
      "description": "Search SAM.gov notices: Sources Sought and Pre-solicitations (the earliest public signal of a purchase), solicitations and combined synopses. Filter by keyword, NAICS, agency, notice type, date.",
      "inputSchema": {
        "properties": {
          "agency": {
            "description": "Department or organization (partial)",
            "type": "string"
          },
          "keyword": {
            "description": "Word in the notice title",
            "type": "string"
          },
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "naics": {
            "description": "NAICS code or prefix, e.g. 3364",
            "type": "string"
          },
          "notice_type": {
            "description": "sources_sought | presolicitation | solicitation | combined",
            "type": "string"
          },
          "since": {
            "description": "ISO date (YYYY-MM-DD); only rows on or after this date",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_opportunities",
      "outputSchema": null
    },
    {
      "description": "Which super PACs are pulling the strings: the largest by money raised, spent or on hand for a cycle, from the FEC's own committee totals. With query or committee_id, one committee's profile: its top donors, what it spent for and against which candidates, and the vendors it paid for campaign work. With shared_vendors, the media buyers and consultancies working for more than one committee. With public_companies, listed companies ranked by the political money they give, resolved to tickers. A committee profile also names the public companies behind its money. Answers \"biggest super PACs this cycle\", \"who funds MAGA Inc\", \"what is America PAC spending on\", \"which firms work for both sides\", \"which public companies give the most\".",
      "inputSchema": {
        "properties": {
          "committee_id": {
            "description": "FEC committee id, e.g. C00879510",
            "type": "string"
          },
          "cycle": {
            "description": "Two-year election cycle (default: current)",
            "type": "number"
          },
          "limit": {
            "description": "Max rows, 1-25 (default 10)",
            "type": "number"
          },
          "min_committees": {
            "description": "With shared_vendors: minimum committees sharing a vendor (default 2)",
            "type": "number"
          },
          "public_companies": {
            "description": "Return publicly traded companies ranked by political money given, resolved to tickers",
            "type": "boolean"
          },
          "query": {
            "description": "Committee name (partial), e.g. \"America PAC\"",
            "type": "string"
          },
          "shared_vendors": {
            "description": "Return vendors paid by two or more committees instead of a committee ranking",
            "type": "boolean"
          },
          "sort": {
            "description": "receipts (default) | independent_expenditures | disbursements | cash_on_hand",
            "type": "string"
          },
          "ticker": {
            "description": "With public_companies: one issuer, e.g. COIN",
            "type": "string"
          },
          "types": {
            "description": "\"all\" to include every PAC type; default super PACs and hybrids only",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "super_pacs",
      "outputSchema": null
    },
    {
      "description": "Every forward call HillSignal made since May 2025, verified against SPY 30 days later, with the inclusion rules and the miss rate.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "track_record",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:22e63ecff55619d1ae2a7c85600cc85e239eede86dd63b886df8b1eb99963b99 | sha256sum