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.

# CLI (npm: @iurco/cli) — the public API from the terminal

npx @iurco/cli services        # what IURCO does
npx @iurco/cli search magento  # full-text search of the site
npx @iurco/cli contact --json  # machine-readable output

# 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 · no auth · JSON · CORS open · read endpoints plus POST /contact to leave a message · errors are JSON objects { error: { code, message, hint, status } }. OpenAPI 3.1 document: /openapi.json (operationIds: listServices, listProducts, getContactInfo, sendContactMessage, 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 ───────────────────────────────────

── TOOLS ─────────────────────────────────────────────────────────────────────

All tools are read-only and idempotent (readOnlyHint: true). Server name: iurco v1.0.0.

list_services — List IURCO services
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_products — List IURCO products
List IURCO's own products (commerce platforms, monitoring, integration hub, commerce operations platform, private AI engine, POS, WMS, CRM) with a description each, and the product's own site when it has one.
input: {"lang":{"type":"string","enum":["es","en"],"description":"Language of the descriptions. Default: en."}}
contact_info — IURCO contact info
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_site_document — Read a document of iurco.com
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."}}
search_site_documents — Search the documents of iurco.com
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, Aleph Commerce, 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 ────────────────────────────────────────────────────────────

── DISCOVERY FILES ───────────────────────────────────────────────────────────

── CONTACT ───────────────────────────────────────────────────────────────────

Questions, bugs or integration requests: info@iurco.com. To hire IURCO: https://iurco.com/en#contacto.