# AIsa MCP > Every AIsa data API as MCP tools behind one Streamable HTTP endpoint: `https://mcp.aisa.one/mcp`. 581 tools across 26 servers, reached through five meta tools, so the catalogue never has to land in a context window. Discovery is free; calls are billed per call against a ceiling the caller sets. This file is rendered by the server it describes. Every count, endpoint and provider below is what this process is serving at the moment you fetched it, not what a manifest was last edited to claim. A client that lists 581 tools has spent its context before the first question. The root lists five instead. `search` takes a plain-language description of the task and hands back candidate operations with their input schemas, so no operation name has to be known in advance; `use` runs one. Everything else is a refinement of those two. ## Connect One URL, `https://mcp.aisa.one/mcp`, transport `streamable-http`. The clients with their own registration command: - Claude Code: `claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp` - Codex: `codex mcp add aisa --url https://mcp.aisa.one/mcp` Cursor, VS Code, Windsurf, Claude Desktop and the rest take the same URL as a `url` entry in their MCP settings. Prefer the client's own mechanism over hand-editing its config file. Authorization is either of two things, and neither needs an account to exist first: - **OAuth.** An unauthenticated call answers 401 with a `WWW-Authenticate` header naming `https://mcp.aisa.one/.well-known/oauth-protected-resource/mcp` (RFC 9728). The authorization server it points to accepts an unregistered client (RFC 7591), so the client registers itself, opens a browser, and the person clicks Allow once. The token belongs to that client and is revocable on its own. - **Bearer.** An AIsa key from console.aisa.one sent as `Authorization: Bearer $AISA_API_KEY`, which skips the browser entirely — the way in when no browser is reachable, such as over SSH or in CI. On the add command that is `--header "Authorization: Bearer $AISA_API_KEY"` for Claude Code and `--bearer-token-env-var AISA_API_KEY` for Codex. That 401 is the discovery mechanism, not a failure. A client reporting that no MCP server is configured is reporting its own state: the URL has not been registered with it yet. ## The five tools - `search` — describe the task in plain words, optionally within one category. Returns candidates with `operation_id`, `input_schema`, price and sometimes a plan. **Free.** - `list_categories` — the categories to narrow a search to. **Free.** - `get_details` — the full contract of one or more operations: argument and response schemas, whether it is read-only, availability, price for the calling account, a `suggested_max_price_usd`, and known pitfalls. **Free.** - `use` — run one operation. Takes `max_price_usd`, which refuses a call costing more than that before anything is charged, then reports what was actually spent. **Billed per call.** - `batch_use` — up to 20 operations at once, under the same cap. **Billed per call.** Two of them answer questions about the caller rather than the world: `use` with `operation_id` `"account"` is free and returns the key, balance, subscription wallet and usage for today, 7 days and 30 days. Every payment error already carries that summary, so a 402 does not need a second call to interpret. The same metric often exists from more than one provider — domain authority from DataForSEO, Semrush and Ahrefs; backlinks from several indexes. When a decision depends on the number, cross-check two. ## What it costs - Free: `search`, `get_details`, `list_categories`. Looking is never charged, so an agent can survey the whole catalogue before spending anything. - Per call: `use` and `batch_use`, billed to the key in the header at the same prices as the AIsa REST API (aisa.one/pricing). No seat, no monthly minimum for the MCP itself. - Capped: `max_price_usd` on any call. Over the ceiling, the call is refused before any charge. - 402 means one of two things and says which: not enough balance, or an operation that needs the Hive GTM Growth subscription. Both answers name what is missing and where to get it. ## Entry points Every path below is the same root pinned to a different slice, so each one still carries the five meta tools, `max_price_usd`, and `search` over the whole catalogue. Pinning changes what `tools/list` returns, never what is reachable. - `https://mcp.aisa.one/mcp` — the root. Five tools, reaches everything. This is what a directory listing should point at. - `https://mcp.aisa.one/mcp?modules=seo,social` — the root with named modules listed directly as well. - `https://mcp.aisa.one//mcp` — an alias of the line above: `seo`, `finance`, `social`, `search`, `sales`, `mail`, `gtm`. - `https://mcp.aisa.one//mcp` — one provider's tools and nothing else. 26 of them, listed below and live at `https://mcp.aisa.one/servers`. ## Categories The curated sets, with the same words `aisa connect` shows for them. Tools listed is what arrives in `tools/list`; reachable is what `search` can still get to from that endpoint. ### Go-To-Market Find the people, size the market, hear the crowd — one URL, eight providers - Endpoint: `https://mcp.aisa.one/gtm/mcp?from=connect` (same thing as `https://mcp.aisa.one/mcp?modules=gtm&from=connect`) - 43 tools listed in `tools/list`, 163 reachable through `search` from here, 8 providers - Providers: Apollo, Creator Discovery, Similarweb, Twitter API, Instagram, Reddit, Pinterest, YouTube Search Everything a growth, sales or marketing agent asks for, behind one endpoint: Apollo people and company data, Similarweb market intelligence, X, Instagram, Reddit, Pinterest and YouTube, creator discovery, plus Semrush and Ahrefs domain metrics. The 43 most-used tools are listed directly; search reaches the rest and every other AIsa category from the same connection. What an agent can do with it: - **Find decision-makers and get their work emails** — Search people by company, title and seniority, then bulk-match to verified emails in one call. Company search and enrichment, job postings and news for intent signals. - **Size a market and its competitors** — Traffic snapshots and six-month trends, audience geography, engagement, similar sites, global and country rankings, and keyword competitors — panel-measured, month-stamped. - **Hear what people say about a brand** — X advanced search, profiles and followers; Instagram profile and post digests; Reddit posts and comments; Pinterest and YouTube search. One page per platform, who is driving it, and "nobody mentioned it" reported honestly. - **Discover creators and reach them** — Similar-creator lookup from any handle and creator email discovery, then profile snapshots across X and Instagram for the shortlist. - **Domain authority and search-side intelligence** — Semrush domain overview, organic keywords, competitors and backlink overview; Ahrefs domain rating; how a brand appears in AI answer engines; YouTube search results. - **Workflows that spend less and never bluff** — Seven GTM workflows with call budgets and fallbacks (Apollo 402 → web search, Similarweb 402 → clickstream estimate, always labelled). Per-call price caps, a free account check, and search that reaches all 578 AIsa tools. A prompt that exercises it: > Use AIsa to find the people running growth and marketing at stripe.com, VP and above, at most 5. Get their emails with one Apollo bulk match and give me name, title, email and email status. Subscription: Requires existing account access and sufficient balance. If either is unavailable, the call returns 402 and the agent reports the limitation without retrying. ### SEO & AI Visibility Rankings, keywords, backlinks, site health — and how AI answers talk about you - Endpoint: `https://mcp.aisa.one/seo/mcp?from=connect` (same thing as `https://mcp.aisa.one/mcp?modules=seo&from=connect`) - 60 tools listed in `tools/list`, 316 reachable through `search` from here, 12 providers - Providers: AI Visibility, App Store Data, Backlinks, Business Listings & Reviews, Content & Sentiment, Technologies & Whois, Keyword Volume & Ads, Domain & Keyword Research, Shopping & Marketplace, On-Page Audit, SERP - Google, SERP - Other Engines DataForSEO, Semrush and Ahrefs together, 60 curated tools listed from 316: keyword research, SERP tracking across Google, Bing and YouTube, backlink profiles, site audits, app and marketplace listings, local business data, and AI-answer visibility across ChatGPT, Claude, Gemini and Perplexity. What an agent can do with it: - **Keyword research with real volumes** — Search volume, difficulty, intent, ideas and related terms; classic Google Ads volume beside AI-assistant query volume. - **Who ranks where** — Google organic, AI Mode, News and Maps, Bing and YouTube SERPs; a domain's organic keywords and competitors. - **Backlinks from more than one index** — Summary, referring domains, anchors, new and lost links, competitor intersections — DataForSEO and Semrush side by side, Ahrefs domain rating to cross-check. - **AI-answer visibility** — What ChatGPT, Claude, Gemini and Perplexity say about a brand, aggregated mention metrics and the domains they cite. - **Site audit in one pass** — Crawl summary, Lighthouse, links, duplicates, non-indexable pages, plus WHOIS and technology detection for any domain. A prompt that exercises it: > Use AIsa to size the keyword "ai agent framework": volume and difficulty, who ranks today, and the related terms with a realistic opening for a new site. ### Finance Prices, fundamentals, filings, crypto and prediction markets - Endpoint: `https://mcp.aisa.one/finance/mcp?from=connect` (same thing as `https://mcp.aisa.one/mcp?modules=finance&from=connect`) - 48 tools listed in `tools/list`, 48 reachable through `search` from here, 4 providers - Providers: MarketPulse, Crypto Market Data, Prediction Market Data, Stock Pulse Market and company data for US-listed companies (prices, financial metrics, earnings, analyst estimates, insider trades, news, SEC filings), CoinGecko crypto markets, and market-implied odds from Polymarket and Kalshi — with a scene agent that aligns what X says about a ticker with how it trades. What an agent can do with it: - **A one-page brief on any listed company** — Price and move, valuation, last earnings versus estimate, what analysts expect, insider activity and the news behind it — six calls, or one batch. - **Fundamentals and filings** — Income statements, balance sheets, cash flows, segmented revenues and SEC filings with the numbers extracted. - **Crypto market picture** — Top coins and movers, trending searches, sector performance, any token's history and market chart. - **Market-implied odds** — Event odds across Polymarket and Kalshi, compared on the same question. A prompt that exercises it: > Use AIsa for a one-page brief on AAPL today: price and move, valuation, last earnings versus estimates, analyst expectations, insider trades and the news that explains the move. ### Social X, Instagram, Reddit, Pinterest and YouTube — public data, page by page - Endpoint: `https://mcp.aisa.one/social/mcp?from=connect` (same thing as `https://mcp.aisa.one/mcp?modules=social&from=connect`) - 56 tools listed in `tools/list`, 56 reachable through `search` from here, 5 providers - Providers: Twitter API, Instagram, Reddit, Pinterest, YouTube Search X/Twitter users, posts, advanced search, followers and trends; Instagram profile and post digests (a few KB instead of hundreds); Reddit posts, subreddits and comments; Pinterest search and boards; YouTube search. What an agent can do with it: - **X in depth** — Profiles, last tweets, advanced search with operators, followers, replies, mentions, trends, user search by keyword. - **Instagram without the payload** — Profile and post digests sized for an agent, profile and hashtag search. - **Reddit, Pinterest, YouTube** — Reddit search, subreddit feeds and comment threads; Pinterest search and boards; YouTube search that says which slice it returned. A prompt that exercises it: > Use AIsa to size up @mkbhd across X and Instagram: audience, posting cadence, median engagement and the two best-performing recent posts on each platform. ### Web Search & Research Web search, page extraction, crawling and grounded research - Endpoint: `https://mcp.aisa.one/search/mcp?from=connect` (same thing as `https://mcp.aisa.one/mcp?modules=search&from=connect`) - 30 tools listed in `tools/list`, 30 reachable through `search` from here, 1 provider - Providers: Web Search Tavily, Exa, Perplexity, Firecrawl, Oxylabs, Brave, Jina, scholar search and Anthropic / OpenAI grounded search behind one connection — search, read the pages that matter, and answer with sources. What an agent can do with it: - **Search that answers with sources** — Tavily and Exa for the open web, Perplexity for a grounded answer, scholar search for papers. - **Read and crawl pages** — Extract a page as clean text, crawl a site, scrape behind anti-bot layers with Oxylabs. - **A research brief in seven calls or fewer** — Dual search, read at most four pages, ask Perplexity only when sources disagree — the workflow sets the budget. A prompt that exercises it: > Use AIsa to research "what changed in the MCP spec in 2026" from the open web, reading at most four pages, and give me a brief with sources and where they disagree. ### Sales People, companies, enrichment and market intelligence - Endpoint: `https://mcp.aisa.one/sales/mcp?from=connect` (same thing as `https://mcp.aisa.one/mcp?modules=sales&from=connect`) - 79 tools listed in `tools/list`, 79 reachable through `search` from here, 3 providers - Providers: Apollo, Creator Discovery, Similarweb Apollo people and company search, enrichment and CRM objects, creator discovery, and Similarweb market intelligence for any domain — the sales category on its own. For the curated growth bundle across categories, pick GTM instead. What an agent can do with it: - **Find and enrich people and companies** — Apollo search by title, seniority, domain and headcount; bulk match and enrichment; job postings and news. - **Market intelligence for any domain** — Similarweb traffic, audience, rankings, similar sites and search rivals, month-stamped. - **Creator discovery** — Similar creators and creator email lookup. A prompt that exercises it: > Use AIsa to find the VP Sales and Head of Partnerships at figma.com and get their work emails with one bulk match. ## Providers One endpoint each, nothing else in `tools/list`. For a caller that already knows which data it needs. - **AgentMail** (49 tools) — `https://mcp.aisa.one/agentmail/mcp` Email inboxes for agents through AIsa: create a real sending and receiving address, read messages and conversation threads, search them, stage drafts and send them, forward, reply and reply-all, manage labels and allow/block lists, and read delivery events. Inboxes are shared across callers on this deployment — every write tool says so, and the six that send mail say it cannot be recalled. - **AI Visibility** (23 tools) — `https://mcp.aisa.one/seo-ai-visibility/mcp` How brands and pages appear inside AI answers: mentions across assistants with aggregated and cross-model metrics, top domains and pages, and raw responses from ChatGPT, Claude, Gemini and Perplexity for a given prompt. - **Apollo** (54 tools) — `https://mcp.aisa.one/apollo/mcp` Apollo B2B sales data and CRM through AIsa: enrich a person or company from whatever identifier you have, search Apollo's global database of people and companies, and read or write the accounts, contacts, deals, tasks, calls, notes and email sequences held in the AIsa Apollo workspace. - **App Store Data** (29 tools) — `https://mcp.aisa.one/seo-apps/mcp` Apple App Store and Google Play data through AIsa: app listings and details, searches, reviews, and app-store search results. - **Backlinks** (27 tools) — `https://mcp.aisa.one/seo-backlinks/mcp` Backlink profiles through AIsa: referring domains and networks, anchors, new and lost links over time, competitor and intersection analysis, and bulk metrics - from DataForSEO and Semrush. - **Business Listings & Reviews** (22 tools) — `https://mcp.aisa.one/seo-business/mcp` Local and reputation data through AIsa: Google Business Profile info and updates, reviews and Q&A, hotel info and searches, business listing search, and Tripadvisor and Trustpilot reviews. - **Content & Sentiment** (10 tools) — `https://mcp.aisa.one/seo-content/mcp` Citations of a brand or phrase across the web: search and summary, category and phrase trends, sentiment analysis and rating distribution. - **Creator Discovery** (2 tools) — `https://mcp.aisa.one/creator-discovery/mcp` Find and contact social creators through AIsa: match YouTube or TikTok creators from a seed profile or a natural-language content direction with similarity scores and follower/view filters, and look up contact emails for a TikTok, Instagram or YouTube creator from their profile URL. - **Crypto Market Data** (21 tools) — `https://mcp.aisa.one/crypto-market-data/mcp` Crypto market data from CoinGecko: spot prices by coin id or contract address, ranked market tables, historical series and OHLC candles, per-venue tickers and liquidity, exchange profiles, sector categories, and the current trending board. - **Domain & Keyword Research** (46 tools) — `https://mcp.aisa.one/seo-labs/mcp` Domain and keyword research through AIsa: domain authority and rank history, ranked and related keywords, keyword ideas and difficulty, search intent, SERP and organic competitors, subdomains and relevant pages, and the Amazon and app store equivalents - from DataForSEO Labs, Semrush and Ahrefs together. - **Instagram** (17 tools) — `https://mcp.aisa.one/instagram/mcp` Read public Instagram through AIsa: profiles, timelines, reels, highlights, comments, video transcripts, and Google-backed search for posts, reels and people. The two heaviest endpoints also come as digest twins that return the same page at roughly 3% of the size, for callers reading rather than downloading. - **Keyword Volume & Ads** (33 tools) — `https://mcp.aisa.one/seo-keywords/mcp` Search volume and advertising data through AIsa: Google Ads and Bing volumes, keyword suggestions and ideas, clickstream volumes, Google Trends, plus Semrush's keyword overview, difficulty, broad-match and question keywords. - **MarketPulse** (21 tools) — `https://mcp.aisa.one/marketpulse/mcp` US equity market data from Financial Datasets — live and historical prices, the three financial statements and the ratios computed off them, reported earnings against estimates, forward analyst consensus, insider transactions, SEC filings down to the item text, a numeric screener, central-bank policy rates — plus Japan's EDINET statutory filing list, raw or as a filterable digest. - **On-Page Audit** (20 tools) — `https://mcp.aisa.one/seo-onpage/mcp` Technical audits of a site through AIsa: crawl a domain and read pages, resources, links, duplicate content and tags, Lighthouse scores, raw HTML, and microdata validation. - **Pinterest** (4 tools) — `https://mcp.aisa.one/pinterest/mcp` Read public Pinterest through AIsa: search pins by keyword, fetch one pin's details and engagement counts, page through a board's pins, and list a user's boards. Every tool accepts trim=true, which measurably shrinks responses (up to 18x) and is documented per tool. - **Prediction Market Data** (5 tools) — `https://mcp.aisa.one/prediction-market-data/mcp` Live prediction-market data from Polymarket and Kalshi: market-implied probabilities, topic-level events, one wallet's on-chain history, and the executed-trade tape — two venues for the same questions, so prices can be cross-checked against each other. - **Reddit** (5 tools) — `https://mcp.aisa.one/reddit/mcp` Read public Reddit through AIsa: search every subreddit or one of them, browse a community's post stream, read a subreddit's size and rules, and pull the comment tree under any post. - **SERP - Google** (38 tools) — `https://mcp.aisa.one/seo-serp/mcp` Google search results through AIsa: organic and paid listings, local finder, images, news, maps, jobs, shopping, finance, autocomplete and the AI overview, plus Semrush's ranked organic and paid results for the same query. - **SERP - Other Engines** (34 tools) — `https://mcp.aisa.one/seo-serp-other-engines/mcp` Search results outside Google: Bing, Yahoo, Baidu, Naver, Seznam and YouTube, plus page screenshots. Same shapes as the Google server, different index. - **Shopping & Marketplace** (22 tools) — `https://mcp.aisa.one/seo-merchant/mcp` Product data from Amazon and Google Shopping through AIsa: product listings and details, sellers, reviews, and shopping search results. - **Similarweb** (23 tools) — `https://mcp.aisa.one/similarweb/mcp` Website and search intelligence from Similarweb through AIsa: monthly traffic and engagement for any domain, its rank, where the traffic comes from by marketing channel, which sites refer it, what it spends on paid search and which ad networks carry its display, who the audience is and what else that audience visits, which sites are similar and how much audience they share, what the site is built with, which of its pages and subdomains earn the traffic, and which keywords and search rivals it has. Calls are billed in Data Credits, per row or per requested metric; use `limit` to bound cost and `max_price_usd` to cap a call. Data vintage: Similarweb reports complete months — a month becomes queryable only after it closes, so say which months a number covers. Every endpoint requires the Hive GTM Growth subscription; without it calls answer 402 — the pay-per-call cross-checks for traffic and authority are DataForSEO Labs' bulk traffic estimation and domain rank overview, one search away. - **Stock Pulse** (4 tools) — `https://mcp.aisa.one/stock-pulse/mcp` What X/Twitter is saying about stocks right now, joined with the market data behind the tickers mentioned — one call instead of four. - **Technologies & Whois** (12 tools) — `https://mcp.aisa.one/seo-domains/mcp` What a domain is built on and who owns it: technology detection per domain, aggregations and stats across technologies, domains using a given technology or HTML term, and whois records. - **Twitter API** (29 tools) — `https://mcp.aisa.one/twitter-api/mcp` Read X/Twitter data through AIsa: user profiles, timelines, followers, tweets, replies, quotes, retweeters, communities, lists, trends and Spaces. - **Web Search** (30 tools) — `https://mcp.aisa.one/web-search/mcp` Search and read the open web through AIsa: ranked results with page text already extracted, single-page and whole-site content extraction, written answers with citations at four depths, web plus academic search with citation counts, semantic search, background jobs for whole-site crawls and research runs, model-grounded answers from Claude and OpenAI models that search as they write, and GEO/AEO queries against the major AI answer engines. - **YouTube Search** (1 tool) — `https://mcp.aisa.one/youtube-search/mcp` Search YouTube through AIsa: matching videos, channels and playlists, with optional country/language narrowing and filter tokens for upload date, duration, and result type. ## One command instead of all of this `curl -fsSL https://aisa.one/install.sh | sh` installs AIsa Connect, which does the whole setup in one pass: it detects the agents on the machine (and installs one if none is there), writes the MCP connection through each agent's own mechanism, adds 22 models behind the same key, and installs the skills that tell the agent when to reach for which category. Two minutes, one click of Allow, no config file edited by hand. `npx @aisa-one/connect connect` does the same where Node is already installed. Run it again later and it is a management page for every connection it made. Skip it if the agent already exists and only needs this one server — the `mcp add` line above is the shorter path. Reach for Connect when the models, the skills and the agent itself are also in scope. ## Check any of this - [https://mcp.aisa.one/servers](https://mcp.aisa.one/servers) — the live inventory this file is rendered from: entry points, modules, per-server endpoints, tool counts, generated per request. - [https://mcp.aisa.one/.well-known/mcp/server-card.json](https://mcp.aisa.one/.well-known/mcp/server-card.json) — the root's server card: tools with their schemas, prompts and resources. - [https://mcp.aisa.one/.well-known/oauth-protected-resource/mcp](https://mcp.aisa.one/.well-known/oauth-protected-resource/mcp) — RFC 9728 metadata, the same document the 401 names. - [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/v0/servers?search=one.aisa) — published in the official MCP Registry under the `one.aisa` namespace: the root as `one.aisa/mcp`, plus one entry per category and per provider. - [aisa.one/mcp](https://aisa.one/mcp) — the same material for a person, and [aisa.one/llms.txt](https://aisa.one/llms.txt) for everything AIsa does beyond MCP.