# Syrto ## Home ### Overview - [Syrto documentation](https://docs.syrto.ai/index.md): Financial intelligence for Italian companies, accessible directly from your AI assistant or over REST. ## MCP ### Getting started - [Introduction](https://docs.syrto.ai/mcp/introduction.md): Use Syrto financial data directly in your AI assistant via the Model Context Protocol. - [API keys](https://docs.syrto.ai/mcp/api-keys.md): Connect to the Syrto MCP server with an organization API key instead of signing in. #### Setup - [Setup](https://docs.syrto.ai/mcp/setup.md): Connect the Syrto MCP server to your AI assistant. - [Claude](https://docs.syrto.ai/mcp/claude.md): Connect Syrto to Claude as a connector. - [Microsoft 365 Copilot](https://docs.syrto.ai/mcp/copilot.md): Connect Syrto to Microsoft 365 Copilot as a source. - [ChatGPT](https://docs.syrto.ai/mcp/chatgpt.md): Connect Syrto to ChatGPT as a custom MCP plugin. ### Tools - [Find company](https://docs.syrto.ai/mcp/tools/find-company.md): Look up a company by name or Italian tax ID to get its company ID. - [Find person](https://docs.syrto.ai/mcp/tools/find-person.md): Resolve a person's name to one or more person IDs, with the companies they are involved in. - [Look up companies by tax ID](https://docs.syrto.ai/mcp/tools/lookup-companies-by-tax-id.md): Batch resolve up to 20 tax IDs to company IDs in a single call. - [Compare companies](https://docs.syrto.ai/mcp/tools/compare-companies.md): Compare specific financial metrics side-by-side across multiple companies. - [Company overview](https://docs.syrto.ai/mcp/tools/company-overview.md): Get a company's qualitative profile: sector, location, activity, and employee count. - [Company branches](https://docs.syrto.ai/mcp/tools/company-branches.md): List a company's registered branches - its secondary registered locations - alongside its headquarters. - [Company structure](https://docs.syrto.ai/mcp/tools/company-structure.md): Get the ownership and organisational structure of a company - officers, shareholders, beneficial owners, and subsidiaries. - [Company analysis](https://docs.syrto.ai/mcp/tools/company-analysis.md): Get a full categorised financial analysis of a company - profitability, liquidity, solvency, and structure - with radar scores in a single call. - [Company metrics](https://docs.syrto.ai/mcp/tools/company-metrics.md): Retrieve specific financial metric values for a company by slug - use when you need metrics outside what syrto_get_company_analysis covers. - [List available metrics](https://docs.syrto.ai/mcp/tools/list-available-metrics.md): Browse all available Syrto financial metrics by type - use this to discover metric slugs before calling syrto_get_company_metrics. - [Spider graphs](https://docs.syrto.ai/mcp/tools/spider-graphs.md): Get thematic financial performance across spider graph axes for a company. - [Radar map](https://docs.syrto.ai/mcp/tools/radar-map.md): Plot companies on the Syrto radar as an interactive chart. - [Radar chart](https://docs.syrto.ai/mcp/tools/radar-chart.md): The Syrto radar positioning chart as a self-contained SVG image. - [Financial statements](https://docs.syrto.ai/mcp/tools/financial-statements.md): List, preview, and generate filled financial statements for a company. - [Metric definitions](https://docs.syrto.ai/mcp/tools/metric-definitions.md): Search for financial metric definitions, formulas, and causal relationships. - [Search companies](https://docs.syrto.ai/mcp/tools/search-companies.md): Find Italian companies by sector, location, size, financial filters, ownership, state aid, or natural language description. - [Aggregate companies](https://docs.syrto.ai/mcp/tools/aggregate-companies.md): Get aggregated financial statistics - count, average, median, min, max - for companies matching sector, region, size, and metric filters. - [Search filter docs](https://docs.syrto.ai/mcp/tools/search-filter-docs.md): Fetch the filter catalog for the search and aggregate tools at runtime. - [Official documents](https://docs.syrto.ai/mcp/tools/official-documents.md): List the registry documents available for a company, retrieve ones already bought, and purchase new ones with organization credits. - [Person contacts](https://docs.syrto.ai/mcp/tools/person-contacts.md): Read the business email addresses and direct phone numbers held for a person, and buy them where they are not held yet. - [Usage](https://docs.syrto.ai/mcp/tools/usage.md): Report how much Syrto AI usage the signed-in user has spent recently, across four time windows. ## API ### Getting started - [Introduction](https://docs.syrto.ai/api/introduction.md): A custom, per-client REST API for Syrto's financial data on Italian companies. - [Standard endpoints](https://docs.syrto.ai/api/standard-endpoints.md): The standard package of endpoints on Italian companies: what each one returns and what it costs. - [Authentication](https://docs.syrto.ai/api/authentication.md): Authenticate to the Syrto API with a bearer API key. - [Your API schema](https://docs.syrto.ai/api/openapi.md): Fetch and preview your organization's OpenAPI schema with your API key, and generate a typed client. - [Sandbox](https://docs.syrto.ai/api/sandbox.md): Build and test an integration against synthetic data, without spending credits. ### Reference - [Errors](https://docs.syrto.ai/api/errors.md): Error response shape and the full list of error codes returned by the Syrto API. - [Rate limits](https://docs.syrto.ai/api/rate-limits.md): How the Syrto API rate-limits requests, and the headers that report your budget. ### Interactive reference - [Standard endpoints](https://docs.syrto.ai/api/reference/standard-overview.md): An interactive reference for the standard endpoints, generated from the API's OpenAPI schema. - [Company overview](https://docs.syrto.ai/api/reference/standard/company-overview.md): One year, a closed list of fields. 404 when the company is unknown or has no filed statement (for the requested year). Price: 10 credits. - [Company anagraphic](https://docs.syrto.ai/api/reference/standard/company-anagraphic.md): State aid and risk indicators have their own endpoints. Price: 10 credits per record returned; notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and will be accepted on the same pa… - [Negativities](https://docs.syrto.ai/api/reference/standard/company-negativities.md): Booleans only. Price: 10 credits per legal entity returned (the individual and consolidated records of one company bill once); notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and… - [State aid (RNA)](https://docs.syrto.ai/api/reference/standard/company-rna.md): Cumulative with a rolling 36-month window, not per financial year. Price: 10 credits per legal entity returned; notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and will be accept… - [Branches](https://docs.syrto.ai/api/reference/standard/company-branches.md): All branches in one response (up to 1000; `truncated` says when there are more). Price: 5 credits. - [Company bundle](https://docs.syrto.ai/api/reference/standard/company-bundle.md): Pure composition of the five endpoints (45 credits separately). Price: 25 credits per record returned; notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and will be accepted on the… - [Structure](https://docs.syrto.ai/api/reference/standard/company-structure.md): Beneficial owners are computed from the shareholding chains. Price: 35 credits per legal entity returned; notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and will be accepted on… - [Financials](https://docs.syrto.ai/api/reference/standard/company-financials.md): No score and no radar. Price: 50 credits, +10 with `includeMarketData` (the market value of each item). - [Reclassified statements](https://docs.syrto.ai/api/reference/standard/company-reclassified.md): All six for the same price. Price: 70 credits. - [Analysis](https://docs.syrto.ai/api/reference/standard/company-analysis.md): Price: 150 credits including five years; each further year returned costs 30. `categories` narrows the output without changing the price. - [Spider graph](https://docs.syrto.ai/api/reference/standard/company-spider.md): Every axis is a 1-5 value relative to the company's market; read it against the axis marketValue. Price: 50 credits including one year; each further year returned costs 10. - [Similar companies](https://docs.syrto.ai/api/reference/standard/company-similar.md): Semantic search on the seed's activity description within a revenue band and an area, best match first; fewer than ten when fewer reach a 0.7 similarity. Price: 150 credits. 404, never billed, when no comparable is found. - [Search](https://docs.syrto.ai/api/reference/standard/company-search.md): Price per company RETURNED, at the tier of the most advanced filter used: base 3, plus 6, pro 10 credits (+10 each with echoFilters). An empty page costs nothing. Set `maxTier` to cap the tier. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is t… - [Market base](https://docs.syrto.ai/api/reference/standard/market-base.md): Price: 150 credits, +50 with a breakdown (macro area or size class; once per call, however many groups). 404, never billed, when no company in the set has filed for the year. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb f… - [Market pro](https://docs.syrto.ai/api/reference/standard/market-pro.md): Price: 750 credits, +250 with a breakdown (macro area or size class; once per call, however many groups). 404, never billed, when no company in the set has filed for the year. The answer is whole or nothing: when a part cannot be computed the call fails (504 or 502), never billed. After a 504, retry… - [Metrics](https://docs.syrto.ai/api/reference/standard/metrics.md): Free. ## OpenAPI Specs - [openapi.standard](/api-reference/openapi.standard.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Italian (52 pages)](https://docs.syrto.ai/_llms/it.txt): Documentation for Italian. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.