Documentation
Tools exposed by SEC Filing Watch and the limits that apply.
Connect
Server URL: https://secwatch.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
find_company
Finds SEC registrants by company name, ticker or CIK and returns CIK, ticker and name.
- Inputs: query, limit (optional)
- Limits: Counts one lookup. At most 25 results. Covers companies in the SEC ticker file.
recent_filings
Recent filings of one company, newest first, optionally limited to form types and a date range, with links to the EDGAR filing index and main document.
- Inputs: company, forms (optional), start and end dates (optional), limit (optional)
- Limits: Counts one lookup. At most 100 filings per call, taken from the company's recent filing list on EDGAR.
get_filing
One filing by accession number: form, dates, item numbers with their titles for an 8-K, and links to the filing index and main document.
- Inputs: company, accession
- Limits: Counts one lookup. The filing must be in the company's recent filing list.
key_financials
Reported revenue, net income, total assets and shares outstanding for recent annual or quarterly periods, from XBRL facts filed with the SEC.
- Inputs: company, period_type (annual or quarterly, optional), periods (optional)
- Limits: Counts one lookup. Up to 8 periods. Values are as tagged by the company; a concept a company does not report is omitted.
search_filings
EDGAR full-text search across filings, with optional form types, company and date range.
- Inputs: query, forms (optional), company (optional), start and end dates (optional), limit (optional)
- Limits: Counts one lookup. At most 25 filings per call (a filing is listed once). EDGAR full-text search covers filings from 2001 onward.
add_watch
Watches a company (optionally for chosen form types) or a form type across all filers, and records what already exists as the baseline.
- Inputs: company (optional), forms (optional; required without a company)
- Limits: Counts one lookup. Watch limit by plan. Form-type watches look at the newest 100 matching filings per check, so a very busy form such as 4 or 8-K is better watched per company.
list_watches
Lists watches with what is watched, last check time and next scheduled check.
- Inputs: none
- Limits: No quota.
remove_watch
Removes a watch by its watch id.
- Inputs: watch_id
- Limits: No quota.
check_now
Checks one watch immediately and reports and records any new filings.
- Inputs: watch_id
- Limits: Counts one lookup.
get_alerts
Recorded alerts, unseen first; marks the returned alerts as seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| lookups | 50 | 2000 |
| watches | 3 | 150 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://secwatch.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.