llms.txt
Compare with other sites' llms.txt files →# DripStack
> Agent-first API for discovering publications, importing Substack feeds, and fetching post summaries with wallet-based payment. Start with the OpenAPI document, search by topic or browse publications, then request paid content when needed.
- App: `https://dripstack.com`
- OpenAPI: `https://dripstack.com/openapi.json`
- Hosted MCP: `https://dripstack.com/api/mcp`
- Onboarding skill: `https://dripstack.com/SKILL.md`
- Full-integration prompt: `https://dripstack.com/integration-prompt.txt`
- Agentic market listing: https://agentic.market
## When to use this
Use Drip when the job is paid research from premium financial newsletters or podcasts. Do not use it as a general web search, a price feed, or a brokerage.
Reach for Drip when you need to:
- Search what newsletter authors and podcast hosts wrote about a ticker, company, theme, or event: `GET https://dripstack.com/api/v1/search?q={query}&limit=10`
- Resolve a source, author, Substack URL, or podcast slug: `GET https://dripstack.com/api/v2/sources/search?q={query}`
- List recent posts or episodes from one source: `GET https://dripstack.com/api/v2/sources/{sourceSlug}`
- Unlock one paid article summary or episode transcript after the user confirms the price: `GET https://dripstack.com/api/v2/sources/{sourceSlug}/{postSlug}`
- Quote then fetch structured stock picks and analyst calls for a UTC day: `GET https://dripstack.com/api/v2/stock-picks/quote` then `GET https://dripstack.com/api/v2/stock-picks`
How to call:
1. Prefer Hosted MCP at `https://dripstack.com/api/mcp`. Discover OAuth at `https://dripstack.com/.well-known/oauth-authorization-server` (also `https://dripstack.com/.well-known/openid-configuration`; issuer `https://dripstack.com/api/oauth`). Protected resource metadata: `https://dripstack.com/.well-known/oauth-protected-resource`.
2. Otherwise use the HTTP API at `https://dripstack.com/openapi.json`. Free discovery needs no credential. Paid routes need MCP OAuth, `Authorization: Bearer pk_drip_…`, or an x402/MPP client.
3. If Drip search is empty, say so. Do not fill gaps from model knowledge or other sites unless the user asks to go outside Drip.
## Integration levels
A full Drip integration spans four levels: Discover (free post cards), Read (paid article summaries), Analyze (stock picks and analyst calls), Operate (credits and account). Wiring only Discover routes returns metadata about articles the caller cannot read - that is a demo, not an integration.
When you are integrating Drip into an app or product, wire all four levels by default: Discover, Read, Analyze (stock picks and analyst calls), Operate (credits and account). Stock picks (GET /api/v2/stock-picks) are the flagship feed; an app with article summaries but no analyst calls misses most of what Drip is for. Use discovery `priceCents` or the live paid response to show what each read costs, and include credit or subscription routes for payment and account status. Only leave a level out when the user says they do not want it, and name the level you left out and what it costs.
- **Discover** (`discover`): Post cards, titles, authors, dates, prices, publications, podcasts, company and entity cards. Cost: Free with an active plan on the account mount, or a $0 wallet identity proof (SIGN-IN-WITH-X or MPP zero-amount) on /api/v2/x402/. Routes: GET /api/v2/search, /api/v2/entities/search, /api/v2/companies/search, /api/v2/sources (wallet twins under /api/v2/x402/)
- **Read** (`read`): Full synthesized summaries of premium posts and podcast transcripts; the first paid read unlocks that post forever. Cost: Per post: plan required plus credits on the account mount, or x402/MPP on the wallet mount. Routes: GET /api/v2/sources/{sourceSlug}/{postSlug} (account) or /api/v2/x402/sources/{sourceSlug}/{postSlug} (wallet)
- **Analyze** (`analyze`): Analyst stock picks, per-ticker calls, bull/bear views, and the full pick archive. Cost: Subscription — plan includes reads; wallet twins are pay-per-use. Routes: GET /api/v2/stock-picks, /api/v2/tickers/{ticker}, /api/v2/stock-picks/quote (account mount; wallet twins under /api/v2/x402/)
- **Operate** (`operate`): Credit balance and top-up, credit ledger, lifetime unlocks, subscription management. Cost: Account plus plan (credits top-up for paid post reads). Routes: GET /api/v2/me, /api/v2/me/credits, /api/v2/me/credits/activity, /api/v2/me/unlocks
Full integration guide: https://docs.dripstack.com/integration-levels
## What this site does
- Searches imported articles by topic
- Lists curated publications
- Fetches one publication and its post summaries
- Imports a publication from its normalized host
- Returns synthesized post summaries (`synthesizedSummary`) from a paid endpoint
- Returns stock-picker calls from a paid endpoint (`/api/v2/stock-picks`)
- Extracts stock picks from pasted article text the subscriber owns (`/api/v2/extract-picks`) — background job, the pasted text is never stored
- Returns every analyst call on one ticker, grouped by analyst (`/api/v2/tickers/{ticker}`)
- Exposes the same discovery + unlock flow over Streamable HTTP MCP
## Payment
- Access is split by mount. **Account (plain `/api/v2/…`)**: Bearer API key / session JWT / MCP OAuth **with an active plan** only — no credential `401`, no plan `403 subscription_required`. There is no free tier. Stock picks, tickers, and writer profiles are included in the plan; paid post reads still spend credits on top of the plan.
- **Wallet (`/api/v2/x402/…`)**: x402 / MPP only — account credentials get `403 wallet_only`. Free browsing routes on this mount use a **zero-dollar identity proof**: sign a CAIP-122 `SIGN-IN-WITH-X` message (x402 wallets) or an MPP zero-amount `proof`; no funds move. Paid wallet routes charge real USDC x402 on Base or Solana (`exact` scheme) or MPP on Tempo — after HTTP `402`, retry with `PAYMENT-SIGNATURE` (x402 v2) or `Authorization: Payment ...` (MPP).
- Default access floor is `1 USD` unless a post-specific price overrides it; stock-picks charge `2 USD` per UTC day, and `2 × days` for a date range (see `/stock-picks/quote`).
- OpenAPI advertises advisory `x-payment-info.offers[]` (Base/Solana USDC x402, Tempo, Stripe); the live `402` challenge is authoritative.
- Plain `curl` is fine for free routes; paid routes require a payment-aware client (e.g. agentic wallet).
- Prefer OAuth for Hosted MCP paid tools (Cursor Connect / `codex mcp login` / host OAuth). Discovery stays public on `/api/mcp` (no transport 401) — probe `/.well-known/oauth-protected-resource` → AS `/api/oauth` (or run host login after adding the MCP URL). CLI / `mcp-remote` can keep `Authorization: Bearer pk_drip_…` (API key from the dashboard). JWT sessions are not accepted for paid MCP tools.
## Endpoints
- `GET /api/v2/x402/search`: Search imported posts by topic (wallet mount: $0 identity auth) (`q, optional limit (1-30), mode`); level: discover; Zero-dollar identity proof: SIGN-IN-WITH-X (CAIP-122) or MPP zero-amount proof; same results as /api/v2/search
- `GET /api/v2/x402/companies/search`: Company identity lookup (wallet mount: $0 identity auth) (`ticker, domain, qid, cik, or name; optional limit (1-10)`); level: discover
- `GET /api/v2/x402/companies/{companyId}`: One company profile (wallet mount: $0 identity auth); level: discover
- `GET /api/v2/x402/entities/search`: Entity search (wallet mount: $0 identity auth); level: discover
- `GET /api/v2/x402/sources`: List curated sources (wallet mount: $0 identity auth); level: discover
- `GET /api/v2/x402/sources/search`: Search curated sources (wallet mount: $0 identity auth) (`q (min 2 characters), optional platform`); level: discover
- `GET /api/v2/x402/sources/{sourceSlug}`: One source with recent posts (wallet mount: $0 identity auth) (`optional limit (1-100)`); level: discover
- `GET /api/v2/x402/tickers/search`: Ticker autocomplete (wallet mount: $0 identity auth; alias /api/v2/x402/tickers) (`optional q, limit (1-15)`); level: discover
- `GET /api/v2/x402/stock-picks/quote`: Quote stock-picks bundle amountUsd (wallet mount: $0 identity auth); level: analyze
- `GET /api/v2/x402/me`: Wallet identity introspection (wallet mount: $0 identity auth); level: operate; Returns verified wallet + unlockCount; wallet-scoped, not the account view
- `GET /api/v2/x402/me/unlocks`: Lifetime unlocks for this wallet (wallet mount: $0 identity auth); level: operate
- `GET /api/v2/search`: Search imported posts by topic (`q, optional limit (1-30), mode`); level: discover; Account mount: plan required. Default discovery route for topic questions
- `GET /api/v2/companies/search`: Look up a company profile by ticker, domain, qid, CIK, or name (`ticker, domain, qid, cik, or name; optional limit (1-10)`); level: discover; Account mount: plan required. Identity lookup, not article search; multiple identifiers are AND (qid > ticker > domain > cik > name); empty match returns items: []
- `GET /api/v2/companies/{companyId}`: Get one company profile by id; level: discover; Account mount: plan required. Returns 404 if unknown or not a company
- `GET /api/v2/sources`: List curated sources (newsletters, podcasts, RSS feeds); level: discover; Account mount: plan required. Envelope { sources: [...] }; each item carries platform (PODCAST_RSS marks podcasts)
- `GET /api/v2/sources/search`: Search curated sources by name, author, or URL (`q (min 2 characters), optional platform`); level: discover; Account mount: plan required. Returns up to 3 matches with sourceSlug, title, author, siteUrl; optional exact platform filter (e.g. PODCAST_RSS for podcasts)
- `GET /api/v2/sources/{sourceSlug}`: Get one source with its recent posts (`optional limit (1-100)`); level: discover; Account mount: plan required. Works for any enabled indexed source, not only the curated list
- `GET /api/v2/sources/{sourceSlug}/{postSlug}`: Get an article summary or podcast transcript (paid, account mount); level: read; paid route; Plan required; credits still charged per read (subscription is the gate, not the payment). First pay unlocks the post forever. Wallet payments go to the /api/v2/x402/ twin
- `GET /api/v2/x402/sources/{sourceSlug}/{postSlug}`: Get an article summary or podcast transcript (paid, wallet mount); level: read; paid route; x402 / MPP micropayments only; account credentials rejected with 403 wallet_only. First pay unlocks the post forever
- `GET /api/v2/sources/{sourceSlug}/stock-picks`: Get one source's analyst profile (paid, account mount); level: analyze; paid route; Plan required; Pro/Expert reads are included in the plan. Wallet payments go to the /api/v2/x402/ twin
- `GET /api/v2/x402/sources/{sourceSlug}/stock-picks`: Get one source's analyst profile (paid, wallet mount); level: analyze; paid route; x402 / MPP micropayments only; one flat price per call
- `GET /api/v2/stock-picks/quote`: Quote stock-picks bundle amountUsd for one UTC day (V2, free) (`optional date (YYYY-MM-DD), optional limit (1-500)`); level: analyze; Account mount: plan required. Free preflight; same price logic as the paid bundle. Returns 404 when none for that day
- `GET /api/v2/stock-picks`: Get stock-picker calls (V2 — preferred, account mount) (`date, or from/to range; optional limit, limitDays, cursor, author, query, sort, includePrices`); level: analyze; paid route; Plan required: PRO/EXPERT served free within their plan window; callers without a plan are rejected (403 subscription_required). Wallet payments go to /api/v2/x402/stock-picks
- `GET /api/v2/x402/stock-picks`: Get stock-picker calls (V2 — wallet mount) (`date, or from/to range; optional limit, limitDays, cursor, sort`); level: analyze; paid route; x402 / MPP micropayments only; pay-per-use bundle pricing, no subscriptions or credits
- `POST /api/v2/extract-picks`: Extract stock picks from pasted article text (subscriber-only, own content) (`title (optional), text (1-15000 chars)`); level: analyze; Plan required (PRO/EXPERT). Returns 202 { id, status: PENDING } and runs the extraction in the background (30-90s); poll GET /api/v2/extract-picks/{id}. Quota: 5/day Personal, 10/day Enterprise; one running extraction per account. The pasted text is never stored — only the resulting picks. Results are advisory and never enter the public picks product. Re-posting identical text returns the cached result instantly
- `GET /api/v2/extract-picks`: List your own stock-pick extractions (subscriber-only); level: analyze; Plan required. Envelope { extractions: [...] } with id, status, title, createdAt, pickCount; newest first
- `GET /api/v2/extract-picks/{id}`: Read one of your own stock-pick extractions (subscriber-only); level: analyze; Plan required. Returns status (PENDING/READY/FAILED), picks, skipped tickers, diagnostics, model, pipelineVersion. Another account's id returns 404. Polling is free and does not consume the monthly request allowance
- `GET /api/v2/me`: Auth introspection for the current API key or OAuth token; level: operate; Credential only (no plan gate) — how callers discover their tier. Requires bearer pk_drip_… or mcp_at_… with mcp:unlock; rejects session JWT
- `GET /api/v2/me/credits`: Purchased credit balance plus topUpUrl / dashboardUrl; level: operate; Plan required. Requires bearer pk_drip_… or mcp_at_… with mcp:unlock; rejects session JWT
- `GET /api/v2/me/credits/activity`: Cursor-paginated credit ledger activity (`optional limit (1-50), optional cursor`); level: operate; Plan required. Requires bearer pk_drip_… or mcp_at_… with mcp:unlock; rejects session JWT
- `GET /api/v2/me/unlocks`: Cursor-paginated posts unlocked for lifetime access (`optional limit (1-50), optional cursor`); level: operate; Plan required. Requires bearer pk_drip_… or mcp_at_… with mcp:unlock; rejects session JWT
- MCP `https://dripstack.com/api/mcp`: tools `search_posts`, `search_entities`, `search_companies`, `get_company`, `list_sources`, `search_sources`, `get_source`, `quote_stock_picks` / `quote_stock_picks_v2` (free), `get_account` / `get_credits_balance` / `get_subscription_upgrade_url` / `list_credit_activity` / `list_unlocked_posts` (OAuth or API key), `unlock_post`, `list_stock_picks` / `list_stock_picks_v2` (OAuth or API key + purchased credits), `extract_picks` / `get_extraction` (OAuth or API key; plan required — paste text, poll for picks); prompts `research-topic`, `browse-publication`, `list-stock-picks`; resources `drip://docs/api`, `drip://publications`, `drip://publications/{slug}` (no paid post bodies). PRM: `https://dripstack.com/.well-known/oauth-protected-resource`; AS: `https://dripstack.com/api/oauth`
## Publication slugs
- Publication slugs are normalized hosts
- Example: `https://bytesbeyondborders.substack.com` -> `bytesbeyondborders.substack.com`
- For custom domains, remove leading `www.`
## Recommended agent flow
Account flows below assume a Bearer credential with an active plan. Wallet agents: use the `/api/v2/x402/…` twins for browsing (zero-dollar identity proof) and for paid reads.
### Topic search (default)
1. Read `https://dripstack.com/openapi.json` (see `info.x-guidance` for full flows)
2. Call `GET /api/v2/search?q={query}&limit=10`
3. Present `items[]` as candidates; keep each item's `publicationSlug` and `slug`
4. Call `GET /api/v2/sources/{sourceSlug}/{postSlug}` with a payment-aware client for selected posts
5. If `503 summary_not_ready`, retry later; if `402`, pay via x402 and retry with `PAYMENT-SIGNATURE`
### Specific publication
1. Call `GET /api/v2/sources/{sourceSlug}`
2. Read `posts[]`, choose a `post.slug`
3. Call the paid post route with a payment-aware client
## Practical notes
- Prefer the OpenAPI document before guessing request or response shapes
- Use publication and post slugs exactly as returned by the API
- Summarize only from fetched `synthesizedSummary` text, not from search snippets alone
## Examples
- `https://dripstack.com/api/v2/search?q=stablecoins&limit=10`
- `https://dripstack.com/api/v2/sources`
- `https://dripstack.com/api/v2/sources/bytesbeyondborders.substack.com`
- `https://dripstack.com/api/v2/sources/bytesbeyondborders.substack.com/some-post-slug`
- `https://dripstack.com/api/v2/stock-picks/quote?date=2026-08-26` (free price preview — V2)
- `https://dripstack.com/api/v2/stock-picks?date=2026-08-26` (V2 — subscription bearer or pay-per-use)
- `https://dripstack.com/api/v2/tickers/NVDA` (V2 — every analyst call on one ticker, grouped by analyst)