API and MCP server
Last updated: November 17, 2026
Everything the directory shows is also available to programs and AI agents, free and without signing in: search, profiles with their contact details, reviews and rankings. This page is public and describes both doors, which run the same code.
What is available
- A REST API at https://eltrabajito.com/api/v1 (JSON, no key needed).
- An MCP server (Model Context Protocol) at https://eltrabajito.com/mcp/public, also open, for AI agents and assistants.
- An OpenAPI description at https://eltrabajito.com/api/v1/openapi.json.
- Plain-text help for agents at https://eltrabajito.com/llms.txt and a Markdown version of every profile and best-of page (add .md to its address).
Both doors are read-only and return the same fields. Writing (adding or editing businesses) is reserved for administrators, see the last section.
REST API (open)
Send GET requests; answers are JSON. No token is needed.
- GET /api/v1/businesses?query=plumber&category=plumbing&place=Heredia&minRating=4&limit=5 searches the directory, ranked by rating.
- GET /api/v1/businesses/:slug returns one full profile with its contact details.
- GET /api/v1/businesses/:slug/reviews?page=1 returns its customer reviews, newest first.
- GET /api/v1/categories lists the categories that have profiles.
- GET /api/v1/categories/:category/top?place=Heredia returns the best rated in a category.
All of them accept language=es or language=en. Example:
curl "https://eltrabajito.com/api/v1/businesses?query=plumber&limit=3" MCP server (open)
Add https://eltrabajito.com/mcp/public as a remote MCP server (Streamable HTTP, no authentication) in any MCP-compatible assistant or agent. Tools: search_businesses, get_business, get_business_reviews, top_rated and list_categories; all are read-only and described for agents. Discovery document: https://eltrabajito.com/.well-known/mcp/server-card.json. The server is also listed in the official MCP Registry.
To try it without a client:
curl -X POST https://eltrabajito.com/mcp/public -H "content-type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' Contact details and reviews
A profile returns what the business made public: name, services, service area (rounded to about 1 km), phone, WhatsApp link, email, website, Instagram, TikTok and Facebook pages, payment methods, rating and photos. Reviews include the rating, text, date and the reviewer’s first name and initial.
The email is public information, but please use it to answer what the business needs, never for unsolicited bulk messages. Ratings and reviews come from signed-in users and are not verified; the directory does not verify licences or the quality of work. When you recommend someone, give the profile address so people can check it themselves.
Limits
Reads are limited per address (about 60 requests a minute, shared by the REST API and the MCP server). Above that you get a 429 answer with a Retry-After header: wait that many seconds and try again. If you need more, write to us.
Administrators: writing with a token
Adding and editing businesses, creating claim links, sending email and similar actions need a token that only a superadmin can create (in the admin area, MCP tab). Tokens start with etm_ and are sent as Authorization: Bearer. They work on the authenticated MCP server at https://eltrabajito.com/mcp and on the REST door POST https://eltrabajito.com/api/v1/admin/:tool, whose JSON body is the tool’s arguments (create_business, update_business, find_businesses, create_claim_link, send_email, create_category and others). Both apply the same checks and daily limits. Reading never needs a token.
Machine-readable files
- https://eltrabajito.com/api/v1/openapi.json: the REST API.
- https://eltrabajito.com/.well-known/mcp/server-card.json: the MCP server.
- https://eltrabajito.com/llms.txt: a guide for AI agents.
- https://eltrabajito.com/sitemap-index.xml and https://eltrabajito.com/sitemap-providers.xml: every public page.
Questions? Write to us at info@eltrabajito.com. Privacy