iurco.com :: developers
Integrate with IURCO — MCP server and machine-readable docs
Everything public about IURCO (services, products, contact, the full site) is available to agents and scripts without authentication: an MCP server, markdown mirrors, a sitemap and schema.org identity. This page is the reference. Human version of the site: https://iurco.com/en. Plain-text index: /ai.
── QUICKSTART ────────────────────────────────────────────────────────────────
Endpoint: https://iurco.com/mcp · transport: Streamable HTTP (JSON-RPC 2.0 over POST) · auth: none · read-only.
# Claude Code
claude mcp add --transport http iurco https://iurco.com/mcp
# Claude Desktop / Cursor / any client that takes an mcpServers config
{
"mcpServers": {
"iurco": { "type": "http", "url": "https://iurco.com/mcp" }
}
}# MCP Inspector (official CLI)
npx @modelcontextprotocol/inspector --cli https://iurco.com/mcp --transport http --method tools/list
# Raw JSON-RPC with curl: initialize
curl -X POST https://iurco.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'── REST API (no MCP client needed) ───────────────────────────────────────────
Base URL https://iurco.com/api/v1 · read-only · no auth · JSON · CORS open · errors are JSON objects { error: { code, message, hint, status } }. OpenAPI 3.1 document: /openapi.json (operationIds: listServices, listProducts, getContactInfo, searchSite — usable as-is for LLM function calling).
curl https://iurco.com/api/v1/services?lang=en curl https://iurco.com/api/v1/products curl https://iurco.com/api/v1/contact curl "https://iurco.com/api/v1/search?q=magento&limit=3"
── VERSIONING, DEPRECATION AND RATE LIMITS ───────────────────────────────────
- Versioning by URL path:
/api/v1is the current, stable version (API-Versionheader on every response). A new major version gets a new path and coexists with the previous one for at least 6 months. - Deprecation: a deprecated version keeps answering but adds
Deprecation: trueandSunset: <date>headers (RFC 9745 / RFC 8594) plus aLink rel="successor-version". Nothing is deprecated today. Changes are announced on this page. - Rate limit: 120 requests per minute per IP. Every response carries
RateLimit-Limit,RateLimit-Remaining,RateLimit-Reset(and theX-RateLimit-*equivalents); over the limit you get429with a JSON error andRetry-After. - The MCP server (
/mcp) follows the MCP protocol version negotiated ininitialize; it is not versioned by path.
── TOOLS ─────────────────────────────────────────────────────────────────────
All tools are read-only and idempotent (readOnlyHint: true). Server name: iurco v1.0.0.
List the services IURCO offers, each with a description. Use it to know whether IURCO does what the user needs (ecommerce, custom software, AI/automation, UX/UI, SEO, social media, paid media).
input:
{"lang":{"type":"string","enum":["es","en"],"description":"Language of the descriptions. Default: en."}}List IURCO's own products (commerce platforms, monitoring, integration hub, private AI engine, POS, WMS, CRM) with a description each.
input:
{"lang":{"type":"string","enum":["es","en"],"description":"Language of the descriptions. Default: en."}}How to reach IURCO: email, contact form URL, location, languages spoken and social profiles. Use it when the user wants to hire or talk to IURCO.
input:
{"lang":{"type":"string","enum":["es","en"],"description":"Preferred language for the contact form link. Default: en."}}Read one of the site's documents in full: 'llms.txt' (short index), 'llms-full.txt' (complete markdown mirror of the site), 'services', 'products', 'contact', 'organization' (schema.org JSON-LD) or 'pages' (every public URL). Same content as the MCP resources, for clients that only use tools.
input:
{"name":{"type":"string","enum":["llms.txt","llms-full.txt","services","products","contact","organization","pages"],"description":"Which document to read."}}Full-text search over the site's markdown mirror (services, products, pages, contact). Returns the paragraphs that mention the query, with the heading they belong to. Use it to answer specific questions about IURCO before reading whole documents.
input:
{"query":{"type":"string","minLength":2,"description":"Words to look for (case-insensitive)."},"limit":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Maximum number of paragraphs to return."}}# Example: search the site
curl -X POST https://iurco.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_site_documents","arguments":{"query":"Magento","limit":3}}}'── RESOURCES ─────────────────────────────────────────────────────────────────
iurco://site/llms.txt (text/markdown)Short index of iurco.com for agents: what IURCO does, when to use it, key pages, contact.
iurco://site/llms-full.txt (text/markdown)Full plain-text mirror of iurco.com in English and Spanish: services, products, pages, contact.
iurco://services (application/json)The services IURCO offers (ecommerce, software, AI & automation, UX/UI, SEO, social, paid media), with a description each. English.
iurco://products (application/json)IURCO's own products (Pampa Commerce, Ceibo Commerce, El Centinela, Andes HUB, Neurus, Posta POS, Estiba WMS, Iurco CRM). English.
iurco://contact (application/json)Email, contact form, location, languages, social profiles and technology partners.
iurco://organization (application/ld+json)Structured identity of the company (JSON-LD): name, address, contact point, sameAs, knowsAbout.
iurco://pages (application/json)Every public page in both languages, as absolute URLs. Case studies and blog posts are listed in the sitemap.
# Example: read a resource
curl -X POST https://iurco.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' \
-d '{"jsonrpc":"2.0","id":3,"method":"resources/read","params":{"uri":"iurco://services"}}'── PROTOCOL NOTES ────────────────────────────────────────────────────────────
- Methods: initialize, ping, resources/list, resources/read, resources/templates/list, tools/list, tools/call, prompts/list (empty), completion/complete.
- Notifications (no id) are accepted with 202. Batches are supported.
- With
Accept: text/event-streamthe response is one SSE event (event: message); otherwise plain JSON. Both are valid Streamable HTTP. - GET and DELETE return 405: the server is stateless, no server-initiated stream and no sessions. Protocol versions 2024-11-05 through 2026-07-28 are accepted (the requested version is echoed).
- CORS is open (
Access-Control-Allow-Origin: *) so browser-based clients work. - Errors follow JSON-RPC: -32700 parse, -32600 invalid request, -32601 unknown method, -32602 bad params / unknown tool, -32002 resource not found.
── DISCOVERY FILES ───────────────────────────────────────────────────────────
- /.well-known/mcp/server-card.json — MCP server card (name, endpoint, tools, resources). Also at /.well-known/mcp.json.
- /.well-known/ai-catalog.json — Agentic Resource Discovery catalog.
- /llms.txt and /llms-full.txt — markdown index and full mirror. Any page also returns markdown with
Accept: text/markdown. - /sitemap.xml and /robots.txt — AI crawlers are explicitly allowed.
- Unknown paths return a real 404 with a markdown body pointing here.
- The same MCP endpoint is mirrored at
https://mcp.iurco.com/mcp.
── CONTACT ───────────────────────────────────────────────────────────────────
Questions, bugs or integration requests: info@iurco.com. To hire IURCO: https://iurco.com/en#contacto.