Docs / Page

MCP Integration

Agentii is built for the agent economy. The Model Context Protocol (MCP) enables AI agents to discover and invoke our tools automatically — no manual API integration required.

Quick Setup

Create an .mcp.json file in your CLI agent's configuration directory. The agent will automatically discover all 19 tools via tools/list.

// .mcp.json — place in your CLI agent's config directory
{
  "mcpServers": {
    "agentii": {
      "url": "https://mcp.agentii.ai/mcp",
      "env": {
        "AGENTII_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

API Key Passthrough

The MCP server does not authenticate independently. It forwards your AGENTII_API_KEY environment variable as the X-API-Key header to api.agentii.ai. Configure the key once in your agent's MCP settings — all 19 tools inherit it.

Verification

Confirm the MCP server is reachable and serving tools:

curl https://mcp.agentii.ai/mcp/health
# => {"status":"ok","version":"1.0.0","tools":19}

curl https://mcp.agentii.ai/mcp/tools/list
# => {"tools":[{...19 tool definitions...}]}

19-Tool Reference

Every REST endpoint is exposed as an MCP tool. Tool names match endpoint path suffixes.

Tool Name	Description	Credits
search_documents	Search 8-K/6-K page-content filings	1
search_sec_filings	SEC filing metadata index (10-K/10-Q/20-F/etc.)	1
search_xbrl_facts	XBRL financial facts by ticker, concept, period	1
list_xbrl_concepts	Distinct XBRL concepts — use before search_xbrl_facts	1
get_company_financials	Company financial overview: filings, highlights, metrics	1
search_companies	Search companies from registry (165 tickers)	1
get_company_profile	Enriched profile with coverage, XBRL count, earnings count	1
search_earnings_calendar	Earnings events with deduplication	1
list_upcoming_earnings	Upcoming earnings dates grouped by report_date	1
list_coverage	Per-source ticker coverage and freshness	1
get_ticker_coverage	Single-ticker coverage across all sources	1
list_domains	Knowledge domains (9 domains)	1
get_company_fiscal_calendar	Fiscal year definition for SEC date alignment	1
search_unified	Cross-source search, results grouped by source_type	3
list_sources	Discover data sources for agentic retrieval	1
read_source_outline	Page map — all page descriptions, no page_content	2
search_keyword_in_source	Keyword FTS — returns page_no + description pairs	2
read_source_pages	Deep read — full page_content markdown with citations	1/page
search_cross_period	Parallel 3-layer protocol across fiscal periods	1/period

Advanced: include=pending

Call tools/list?include=pending to receive the full P0 + P2 tool surface (~32 tools). P2 tools return 503 DATA_NOT_AVAILABLE until their backing data tables are populated. Default response includes only P0 tools.