Skip to content

docs(mcp): document ultrasearch headlines, jobs, papers, compact records and billing - #1801

Merged
capy-ai[bot] merged 6 commits into
mainfrom
kris/ultrasearch-docs-v4
Nov 18, 2026
Merged

capy-ai[bot] merged 6 commits into
mainfrom
kris/ultrasearch-docs-v4

Conversation

@KrisOei

@KrisOei KrisOei commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Documents the next Ultrasearch release on the MCP tools page.

Merge only after the matching hosted MCP server and billing changes are released. Until then, this page would describe behaviour that isn't live yet.

  • Stock headlines. The answer picks headlines by what the query asks: 1 per ticker for a price ask, 2 for a bare ticker, and 3 for news, a move, earnings or outlook. Headlines about the asked company come first. Other stories Benzinga tags with the ticker fill any gap and are marked "focus": "tagged". Each headline has only title, created and url.
  • News charge. A stock answer with headlines costs 2 credits on top of the search. A stock answer with no headlines costs nothing extra, and the delayed price stays free. A sources list with news but neither web nor alexandria now gets stock answers at the same price.
  • Triggering. A bare person name can look up the exactly matching LinkedIn profile among the first results. A bare brand can look up the company behind its own site. Finance asks such as TSLA EPS or Verizon dividend now get a stock answer, and a product name with a price word no longer does.
  • Compact records. Person and company answers carry one compact person or company record in place of the provider's raw payload. Funding and location say not in this record when the source has none.
  • Person lookups. When the first source has no profile, the lookup can try up to two more sources, and only the one that finds the person is billed.
  • Jobs and papers. A jobs ask about one company named by its LinkedIn page returns up to 5 open postings, billed per posting up to 10 credits. An arXiv id or DOI returns the paper's metadata and a short abstract, free.
  • Billing table. The cost table now lists person, company, jobs, paper and stock answers.

Show me

flowchart LR
  Q[firecrawl_search] --> R{one subject}
  R -->|person| P1[first source] -->|no profile| P2[up to 2 more sources]
  P1 & P2 --> PR[person record: typically 5, or 2 or 10, max 20]
  R -->|company| C[company record: typically 2, max 20]
  R -->|jobs + LinkedIn company page| J[up to 5 postings: per posting, max 10]
  R -->|arXiv id or DOI| A[paper: free]
  R -->|1 to 3 stocks, also news-only| S[headlines: +2, price free]
Loading
 "answer": {
   "route": "person",
-  "data": { "full_name": "...", "job_title": "...", "location_name": "..." },
+  "person": { "name": "...", "headline": "...", "current_roles": [...], "location": "not in this record", ... },
+  "match": "high confidence",
   "credits": { ... }
 }

Stock answers carry a 15-minute-delayed price per ticker, answer price asks and up to three named stocks, and return compact stories with tickers. Benzinga news needs no terms acceptance.
…r triggering

Stock answers choose headlines by what the query asks and cost 2 credits when headlines are found. Bare names, bare brands and stock finance asks now get answers.
@KrisOei
KrisOei changed the base branch from kris/ultrasearch-docs-live to main November 17, 2026 18:51
@mintlify

mintlify Bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Nov 18, 2026, 4:07 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@capy-ai capy-ai Bot changed the title docs(mcp): document ultrasearch stock headlines, news charge and triggering docs(mcp): document ultrasearch headlines, jobs, papers, compact records and billing Nov 18, 2026
@capy-ai
capy-ai Bot merged commit 377947e into main Nov 18, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
staging — 0910bfef Deployed Nov 18, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant