{"serverInfo":{"name":"aisa","title":"AIsa","version":"1.0.0","websiteUrl":"https://aisa.one","description":"AIsa is one key for 950+ data APIs across six categories: SEO & AI visibility (DataForSEO, Semrush, Ahrefs), finance (prices, fundamentals, filings, crypto, prediction markets), social (X/Twitter, Instagram, Reddit, Pinterest, YouTube), web search & research (Tavily, Firecrawl, Exa, Perplexity, Oxylabs), sales (Apollo, creator discovery) and agent mail (AgentMail). How to work: call search with a plain-language description of the task; it returns candidates with operation_id and input_schema (and sometimes a plan). Then use with the operation_id and arguments, or batch_use for up to 20 at once; get_details gives the full contract, price and pitfalls when you need them. search, get_details and list_categories are free; use and batch_use are billed per call to the AIsa key in the Authorization header. For paid calls you can set max_price_usd to refuse anything more expensive before any spend. Tools listed directly in tools/list (pinned by ?modules= on the URL) can be called directly without search. To see who you are, what you can use and how much you can spend — key, account balance, the Hive GTM subscription wallet, usage for today / 7 days / 30 days — call use with operation_id \"account\" (free). Every payment error already carries that summary and a brief balance or access error. 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 providers. Some endpoints are premium and require the Hive GTM Growth subscription; a 402 response reports insufficient balance or account access. Everything else is pay-per-call.","icons":[{"src":"https://mcp.aisa.one/icon.svg","mimeType":"image/svg+xml"}]},"authentication":{"required":true,"schemes":["oauth2","bearer"],"resourceMetadata":"https://mcp.aisa.one/.well-known/oauth-protected-resource/mcp"},"tools":[{"name":"list_categories","title":"Browse the AIsa catalogue","description":"The AIsa catalogue at a glance: categories, the servers in each, tool counts, and the dedicated endpoint to connect if you only need one category. Free; no key needed. (AIsa-only: tool-router has no equivalent.) Use `mcp.aisa.one/mcp?modules=<category>` (or `mcp.aisa.one/<category>/mcp`) to have that category's tools listed directly instead of via search.","inputSchema":{"additionalProperties":false,"properties":{},"type":"object"},"outputSchema":{"additionalProperties":true,"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"search","title":"Find AIsa operations","description":"Find AIsa data operations across SEO & AI visibility, finance, social, web search & research, sales and agent mail — 950+ APIs — by describing the task. Free; no key needed. Returns tool-router's SearchResponse: retrieval_mode (plan | endpoint | clarification), an optional plan, and candidates with operation_id, provider, method, path, summary, required_inputs, price, match_reasons and details_ref — plus input_schema, so a candidate can be passed to `use` without calling get_details, and `modules`, the entry points that pin it. Search spans the full AIsa catalogue, not only the category pinned on this endpoint, so an operation is discoverable here even when it is not in the current tools/list; a candidate whose `modules` does not include the current one still runs. When more than one provider offers the same metric, the candidates make that visible.","inputSchema":{"additionalProperties":false,"properties":{"query":{"description":"What you need, in plain language, e.g. 'backlinks of a domain', 'recent tweets by a user', 'insider trades for AAPL'. English works best.","type":"string"},"limit":{"default":5,"description":"Maximum candidates, 1-10","type":"integer"},"category":{"anyOf":[{"type":"string","enum":["seo","finance","social","search","sales","mail"]},{"type":"null"}],"default":null,"description":"Restrict to one category (seo, finance, social, search, sales, mail). Omit to search everything."}},"required":["query"],"type":"object"},"outputSchema":{"additionalProperties":true,"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"get_details","title":"Show operation details","description":"Full contract of one or more operations: arguments_schema, response_schema, read_only, side_effects, availability, price, suggested_max_price_usd and known_pitfalls. Free — a quote authenticates like a call but stops before any spend. `price.model` distinguishes the sources: `quoted` is what this account would be charged now, `list` is the published price, `dynamic` means the price varies with the request and only a quote states it, `composed` means the operation runs several upstream calls. `suggested_max_price_usd` is that estimate with headroom, in the shape use and batch_use take as `max_price_usd`.","inputSchema":{"additionalProperties":false,"properties":{"operation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One operation_id from search"},"operation_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Up to 20 operation_ids, for a batch"},"with_quote":{"default":true,"description":"Whether each operation is priced for this account before the answer. One round trip per operation; spends nothing.","type":"boolean"},"arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"description":"The arguments the operation would be called with, for a price that reflects them. Keyed by operation_id for a batch, or passed flat for a single operation_id. Routes whose required parameters are validated before pricing have no price without them."}},"type":"object"},"outputSchema":{"additionalProperties":true,"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"use","title":"Run an AIsa operation","description":"Execute one AIsa operation. Billed per call to your AIsa key. Answers in tool-router's BatchCallResult shape: successful, data or error {type, status, message, retryable}. Pinned tools in tools/list can also be called directly; this is the way to call anything found through search.","inputSchema":{"additionalProperties":false,"properties":{"operation_id":{"description":"operation_id as returned by search","type":"string"},"arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"description":"Arguments matching input_schema / arguments_schema"},"max_price_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Refuse the call before any spend if it would cost more than this many USD"},"search_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"search_id from the search that found this operation"}},"required":["operation_id"],"type":"object"},"outputSchema":{"additionalProperties":true,"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"openWorldHint":true}},{"name":"batch_use","title":"Run up to 20 operations","description":"Execute up to 20 operations concurrently (tool-router's batch_use). Each item answers independently; one failure never cancels the others. Billed per call to your AIsa key.","inputSchema":{"additionalProperties":false,"properties":{"calls":{"description":"Up to 20 items of {call_id, operation_id, arguments}; steps at the same execution_level of a plan go in one batch","items":{"additionalProperties":true,"type":"object"},"type":"array"},"max_price_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Per-call price cap applied to every item"},"search_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"search_id from the search that found these operations"}},"required":["calls"],"type":"object"},"outputSchema":{"additionalProperties":true,"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"openWorldHint":true}}],"prompts":[{"name":"seo","title":"AIsa SEO & AI Visibility","description":"Search and AI-answer visibility: rankings, keywords, backlinks, site health, app and marketplace listings, local business data, and how a brand shows up in ChatGPT, Claude, Gemini and Perplexity answers. DataForSEO, Semrush and Ahrefs together. 316 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"finance","title":"AIsa Finance","description":"Market and company data: prices, fundamentals, filings, insider trades, crypto markets, prediction markets, and a scene agent that aligns what X is saying about tickers with how they are trading. 49 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"social","title":"AIsa Social","description":"Public social data: X/Twitter users, posts, search and trends; Instagram, Reddit and Pinterest profiles and content; YouTube search. 56 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"search","title":"AIsa Web Search & Research","description":"Web search, page extraction, crawling and grounded research through Tavily, Firecrawl, Exa, Perplexity, Oxylabs, txyz, and Anthropic/OpenAI grounded search. 27 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"sales","title":"AIsa Sales","description":"People and company search, enrichment, sequences and CRM objects through Apollo, creator discovery, and Similarweb market intelligence: any domain's traffic, audience, rankings and search rivals. 79 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"mail","title":"AIsa Agent Mail","description":"Inboxes, threads, drafts and sending for agents through AgentMail. 49 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"gtm","title":"AIsa Go-To-Market","description":"Go-to-market data in one set: people and company search (Apollo), creator discovery, X/Twitter, Instagram, Reddit, Pinterest and YouTube, Similarweb market intelligence, plus the Semrush, Ahrefs, Oxylabs and DataForSEO YouTube operations. Mirrors the Hive GTM Growth subscription: every operation here is subscription-only on the gateway, so a key without the plan gets 402 on all of them. 163 operations; brief + how to search and call. Optional task: what you want to find out."},{"name":"brand_mentions_across_social","title":"What people are saying about a brand across X, Reddit and Instagram","description":"One pass over the three public social sources for a brand, product or topic: the recent posts, where the conversation is, and what is missing. Sets the source order, the page budget and when to stop; it does not score sentiment for you."},{"name":"competitor_teardown","title":"Tear down a competitor or market from one domain","description":"From one domain to a market map: how big its traffic is, which sites compete for the same audience, where that audience lives, who the search-side rivals are (often a different list — say so), and how the top competitors measure on the same yardstick. Sets the call order, the budget and the data-vintage rules; the judgement stays with the reader."},{"name":"creator_profile_snapshot","title":"Size up a creator or public account across X and Instagram","description":"Audience, activity and recent content of one person or brand account on X and Instagram, from the compact digests first and the raw feeds only when needed. Sets the order and the page budget; it does not judge brand fit."},{"name":"seo_ai_visibility","title":"How a brand shows up in AI answers","description":"Measure a brand or domain's presence in ChatGPT, Gemini and Perplexity answers: how often it is mentioned, on which prompts, which sources the models cite instead, and what the models say today when asked directly. Sets the call order and the budget; it does not write the positioning."},{"name":"seo_keyword_opportunity","title":"Size a keyword and find the openings around it","description":"Decide whether a keyword is worth going after: volume and difficulty, the related terms that are easier, and what is actually on page one now. Sets the call order and the stopping rules; it does not write the content."},{"name":"seo_site_audit","title":"Audit a site's SEO health in one pass","description":"A defensible first-pass SEO health check of one domain: authority, organic footprint, backlink profile, top competitors and page speed. Sets the call order, when to cross-check two providers and when to stop; it does not decide what to fix first."},{"name":"enrich_lead_list","title":"Enrich a list of leads and their companies in bulk","description":"Turn a list of emails or names into people with titles, companies and verified contact details, plus the company facts behind them — using the bulk endpoints so one call does ten. Sets the batch size and the credit rules; it does not write anything back to Apollo."},{"name":"find_people_at_company","title":"Find the right people at one company and get their work emails","description":"From a company domain to a shortlist of named people with verified work emails: enrich the company, search people by title, then match each shortlisted person for contact details. Sets the order and the credit budget; it does not write to Apollo (no contacts, no sequences)."},{"name":"crypto_market_health","title":"Where the crypto market is today, in four calls","description":"Market-wide read: the largest coins and their moves, what is trending, which sectors are up, and how Bitcoin traded over the last week. Sets the order and the size of each call; it does not predict."},{"name":"look_up_token_market","title":"Look up a coin or token's market picture on CoinGecko","description":"Resolve an ambiguous ticker, name or contract address into a single CoinGecko asset, then pull its current numbers and — only if asked — history and venue liquidity. Handles the two traps that make CoinGecko answers wrong rather than merely incomplete: ticker symbols are not unique, and half the endpoints want a CoinGecko id while the other half want a chain plus a contract address."},{"name":"compare_event_odds","title":"Compare market-implied odds across Polymarket and Kalshi","description":"Look up what prediction markets currently imply about an event, checking Polymarket against Kalshi so a single venue's pricing is never the only evidence. Handles the two venues' incompatible identifiers and filters, and says plainly when only one side has a market."},{"name":"track_topic_on_x","title":"Track what X/Twitter is saying about a topic","description":"Assemble a defensible picture of what X/Twitter is saying about a topic: which posts, from whom, how the conversation is shaped, and what is missing. Sets the call order and the stopping conditions; it does not decide what the chatter means."},{"name":"research_brief","title":"Research a question from the open web, with sources","description":"A sourced answer to one question: two complementary searches, the full text of the few pages that matter, and a short brief with citations. Sets the order, the page budget and when a synthesis model is worth its price; it does not replace reading the sources."},{"name":"search_youtube_deliberately","title":"Search YouTube without silently getting the wrong slice","description":"Run a YouTube search where the locale and the filter token are chosen on purpose rather than left to chance, and report the result set in a way the reader can audit. Covers the two parameters that quietly change what comes back."},{"name":"company_fundamentals","title":"Assemble the fundamentals picture for a US-listed company","description":"Resolve a company, then pull the slices of its financial record that the question actually needs — price, statements, ratios, earnings, insiders, filings — without dragging back everything. Encodes the two things that reliably go wrong here: half these tools refuse to answer without a period argument, and several pairs look interchangeable but differ by an order of magnitude in how much they return."},{"name":"stock_snapshot_brief","title":"A one-page brief on a listed company, today","description":"Price, valuation, latest earnings, what analysts expect, who inside is buying or selling, and the news behind it — six calls, one page. Sets the order and where to stop; it does not give investment advice."},{"name":"stock_chatter_workflow","title":"Work through stock chatter on X, with the market data behind it","description":"Decide between the one-call bundle and the underlying atomic tools when looking at what X/Twitter is saying about stocks, then read the result honestly — including which sources failed and what the mention counts do and do not mean."}],"resources":[{"name":"venue_field_map","uri":"aisa://prediction-market-data/venue-field-map","title":"Field-by-field map between Polymarket and Kalshi","description":"Field-by-field mapping between Polymarket and Kalshi for the concepts that do not translate cleanly: identifiers, pagination, time filters, and status. Read this before querying both venues for the same question — three of the differences (boolean vs enum status, ISO vs Unix timestamps, offset vs cursor paging) produce wrong results rather than errors.","mimeType":"text/markdown"},{"name":"topic_report_template","uri":"aisa://twitter-api/topic-report-template","title":"Structure for a defensible X/Twitter topic report","description":"A section-by-section skeleton for writing up X/Twitter topic research so a reader can audit it: what was searched, what came back, who said it, and what is missing. Read this when the deliverable is a written report rather than raw posts. Pairs with the track_topic_on_x prompt, which covers how to gather the material.","mimeType":"text/markdown"},{"name":"reading_the_bundle","uri":"aisa://stock-pulse/reading-the-bundle","title":"How to read what stock_pulse returns","description":"What each field in the twitter_stock_pulse response actually means, and the three ways it is commonly misread: treating `mentions` as a ranking, missing a partial failure recorded in `coverage`, and not noticing that one tool call billed several upstream calls. Read once before interpreting the bundle; it does not change between calls.","mimeType":"text/markdown"}]}