{"openapi":"3.1.0","info":{"title":"Intelica","description":"Competitive intelligence API — pay-per-call via x402","version":"4.5.0"},"paths":{"/llms-full.txt":{"get":{"summary":"Complete llms.txt — full content for agents that need everything in one file","description":"Full llms.txt — complete API reference embedded without external fetches required.","operationId":"llms_full_txt_llms_full_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Fetch llms.txt discovery file for LLM and agent integration","description":"Standard llms.txt for LLM and agent discovery.","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Fetch service health and cache statistics","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Fetch Intelica API overview and available endpoints","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402":{"get":{"summary":"Fetch x402 payment manifest with Base and Solana options","operationId":"x402_manifest__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"summary":"Health check for x402 manifest endpoint","operationId":"x402_head__well_known_x402_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402.json":{"get":{"summary":"Fetch x402 payment manifest with Base and Solana options","operationId":"x402_manifest__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"summary":"Health check for x402 JSON manifest endpoint","operationId":"x402_head__well_known_x402_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/security.txt":{"get":{"summary":"Security contact information","operationId":"security_txt__well_known_security_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/security.txt":{"get":{"summary":"Security contact information","operationId":"security_txt_security_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/privacy-policy":{"get":{"summary":"Privacy policy","operationId":"privacy_privacy_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/privacy":{"get":{"summary":"Privacy policy","operationId":"privacy_privacy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/ai-plugin.json":{"get":{"summary":"OpenAI plugin manifest — auto-discovery for ChatGPT and LangChain agents","description":"Standard OpenAI plugin manifest. Used by ChatGPT plugins, LangChain, AutoGPT, CrewAI and other OpenAI-compatible agents for automatic API discovery.","operationId":"ai_plugin_json__well_known_ai_plugin_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/mcp.json":{"get":{"summary":"MCP auto-configuration — used by Claude Desktop, Cursor, Continue and other MCP clients","description":"MCP client auto-configuration file. Allows MCP clients to discover and configure the Intelica MCP server without manual setup.","operationId":"mcp_config_json__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/pay.json":{"get":{"summary":"x402 payment configuration — standard pay.json for x402-compatible agents","description":"Standard x402 pay.json for agents that auto-discover payment configuration before making API calls.","operationId":"pay_json__well_known_pay_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/mcp/server-card.json":{"get":{"summary":"MCP server card — alias for mcp-server-card.json","description":"Alias — some crawlers look for MCP server card at this path.","operationId":"mcp_server_card_well_known__well_known_mcp_server_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap for web crawlers","description":"Basic sitemap for SEO crawlers.","operationId":"sitemap_xml_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/openapi.yaml":{"get":{"summary":"OpenAPI schema in YAML format","operationId":"openapi_yaml_openapi_yaml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots.txt for web crawlers","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/glama.json":{"get":{"summary":"Glama MCP connector verification","operationId":"glama_json__well_known_glama_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/terms-of-service":{"get":{"summary":"Terms of service","operationId":"terms_terms_of_service_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/terms":{"get":{"summary":"Terms of service","operationId":"terms_terms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/pricing":{"get":{"summary":"Fetch pricing details for all Intelica endpoints","operationId":"pricing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp":{"get":{"summary":"Fetch MCP server info and available tools","operationId":"mcp_info_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Execute MCP JSON-RPC tool call for competitive intelligence","description":"MCP server — JSON-RPC 2.0.","operationId":"mcp_endpoint_mcp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"summary":"Health check for /mcp endpoint","operationId":"mcp_head_mcp_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp-server-card.json":{"get":{"summary":"Fetch Intelica agent card for MCP server discovery","operationId":"agent_card_mcp_server_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/agent-card.json":{"get":{"summary":"Fetch Intelica agent card for MCP server discovery","operationId":"agent_card_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/agentcard.json":{"get":{"summary":"Fetch Intelica agent card for MCP server discovery","operationId":"agent_card_mcp_agentcard_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Fetch agent card","operationId":"agent_card__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent-registration.json":{"get":{"summary":"Fetch agent registration metadata for discovery","operationId":"agent_registration__well_known_agent_registration_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/x402/discovery/resources":{"get":{"summary":"Fetch Bazaar-compatible discovery catalog for x402 agents","description":"Bazaar-compatible discovery endpoint for x402 agent indexers.","operationId":"discovery_resources_x402_discovery_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402/discovery/resources":{"get":{"summary":"Fetch Bazaar-compatible discovery catalog for x402 agents","description":"Bazaar-compatible discovery endpoint for x402 agent indexers.","operationId":"discovery_resources__well_known_x402_discovery_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/x402/discovery/resources":{"get":{"summary":"Fetch Bazaar-compatible discovery catalog for x402 agents","description":"Bazaar-compatible discovery endpoint for x402 agent indexers.","operationId":"discovery_resources_v2_x402_discovery_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/discovery/resources":{"get":{"summary":"Fetch Bazaar-compatible discovery catalog for x402 agents","description":"Bazaar-compatible discovery endpoint for x402 agent indexers.","operationId":"discovery_resources_v1_x402_discovery_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/discovery/resources":{"get":{"summary":"Fetch Bazaar-compatible discovery catalog for x402 agents","description":"Bazaar-compatible discovery endpoint for x402 agent indexers.","operationId":"discovery_resources_discovery_resources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/graph":{"get":{"summary":"Fetch competitive graph nodes, edges, and hub competitors","description":"Competitive Graph — mapa de relaciones entre competidores.\n\nSin parámetros: retorna el grafo completo con los nodos más analizados.\nCon ?company=Notion: retorna el subgrafo centrado en esa empresa.\n\nIncluye hub_competitors — empresas que aparecen más frecuentemente\ncomo competidores en múltiples análisis.","operationId":"competitive_graph_graph_get","parameters":[{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/message/send":{"post":{"summary":"Send A2A protocol message and receive competitive analysis","description":"A2A Protocol — message/send endpoint.\nCompatible con LangGraph, CrewAI, AutoGen, Google ADK.\nAcepta mensajes A2A y retorna análisis competitivo estructurado.\nModo gratuito para descubrimiento — análisis básico sin pago.","operationId":"a2a_message_send_message_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/A2ASendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/intel":{"head":{"summary":"Health check for /intel endpoint","operationId":"intel_head_intel_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"get":{"summary":"Payment challenge for /intel — x402 discovery probe","description":"Returns x402 payment challenge for agent discovery and x402scan indexing.","operationId":"intel_get_intel_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Analyze competitor URL or text — returns structured intelligence","description":"Single competitive intelligence analysis — $0.05 USDC via x402 or X-SESSION for plan holders.","operationId":"intel_intel_post","parameters":[{"name":"x-payment","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Payment"}},{"name":"x-session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/batch":{"get":{"summary":"Payment challenge for /batch — x402 discovery probe","description":"Returns x402 payment challenge for agent discovery and x402scan indexing.","operationId":"batch_get_batch_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Analyze up to ten competitors in parallel via x402 payment","description":"Batch competitive intelligence — up to 10 items for 0.20 USDC via x402, X-SESSION, or X-API-KEY.","operationId":"batch_batch_post","parameters":[{"name":"x-payment","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Payment"}},{"name":"x-session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/demo":{"get":{"summary":"Demo endpoint info","description":"Returns demo endpoint info — free analysis with 300 char limit.","operationId":"demo_get_demo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Analyze competitor text free — demo limited to 300 characters","description":"Free demo — 300 char text limit, no URL fetching. 3 calls per IP per hour.","operationId":"demo_demo_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/access/activate":{"post":{"summary":"Activate a time-based access plan with USDC payment on Solana","description":"Verifica pago USDC en Solana via Helius y activa sesión de acceso.","operationId":"access_activate_access_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/access/status":{"get":{"summary":"Check remaining reports and expiry for a session","description":"Retorna el estado actual de una sesión de acceso.","operationId":"access_status_access_status_get","parameters":[{"name":"session","in":"query","required":true,"schema":{"type":"string","title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/access/webhook/helius":{"post":{"summary":"Helius webhook — receives USDC payment notifications","description":"Recibe notificaciones de Helius cuando llega USDC a la wallet de Intelica.","operationId":"access_webhook_helius_access_webhook_helius_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/access/api-key":{"post":{"summary":"Create an API key — load USDC balance for agent use without per-call wallet","description":"Crea una API key con saldo USDC. Los agentes usan X-API-KEY header en lugar de wallet por call.","operationId":"access_create_api_key_access_api_key_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/access/api-key/status":{"get":{"summary":"Check API key balance and usage","description":"Verifica el saldo y uso de una API key.","operationId":"access_api_key_status_access_api_key_status_get","parameters":[{"name":"key","in":"query","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/access/pending":{"post":{"summary":"Create a pending payment — returns payment_id for polling","description":"Crea un pago pendiente. La página hace polling hasta que Helius confirme.","operationId":"access_pending_access_pending_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/access/pending/{payment_id}":{"get":{"summary":"Poll payment status — returns session_id when confirmed","description":"Polling endpoint. La página llama esto cada 5 segundos hasta recibir session_id.","operationId":"access_pending_status_access_pending__payment_id__get","parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"A2AMessage":{"properties":{"role":{"type":"string","title":"Role","default":"user"},"parts":{"items":{"$ref":"#/components/schemas/A2AMessagePart"},"type":"array","title":"Parts"},"messageId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Messageid"},"contextId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contextid"},"taskId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taskid"}},"type":"object","required":["parts"],"title":"A2AMessage"},"A2AMessagePart":{"properties":{"type":{"type":"string","title":"Type","default":"text"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","title":"A2AMessagePart"},"A2ASendRequest":{"properties":{"message":{"$ref":"#/components/schemas/A2AMessage"}},"type":"object","required":["message"],"title":"A2ASendRequest"},"AccessActivateRequest":{"properties":{"plan":{"type":"string","title":"Plan"},"tx_hash":{"type":"string","title":"Tx Hash"}},"type":"object","required":["plan","tx_hash"],"title":"AccessActivateRequest"},"BatchItem":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode","default":"competitive"},"operator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator Id"}},"type":"object","title":"BatchItem"},"BatchRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BatchItem"},"type":"array","maxItems":10,"minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"BatchRequest"},"DemoRequest":{"properties":{"text":{"type":"string","maxLength":300,"title":"Text"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode","default":"competitive"}},"type":"object","required":["text"],"title":"DemoRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IntelRequest":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode","default":"competitive"},"operator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator Id"},"force_refresh":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Force Refresh","default":false},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format","default":"json"}},"type":"object","title":"IntelRequest"},"MCPRequest":{"properties":{"jsonrpc":{"type":"string","title":"Jsonrpc","default":"2.0"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"method":{"type":"string","title":"Method","default":"initialize"},"params":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Params"}},"additionalProperties":true,"type":"object","title":"MCPRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}