Laspi Business Directory — connector documentation
A read-only directory of small businesses that an AI assistant can search. Every card is published by the business owner, who confirms its details.
What it is
- It only reads. It never books, buys, messages a business or changes anything.
- It answers strictly from the directory. When no business fits, it says so instead of guessing.
- The directory is small and growing: it covers only the businesses that chose to be listed — in Spain and other European countries, and online. It is not a complete map of any city.
- A card holds what a customer needs before getting in touch: what the business does, its services, the city or whether it works online, the languages it serves customers in, and its public contacts. Each card has a public page at laspi.pro/b/{slug}.
Server
- Address
https://laspi.pro/api/v1/mcp/directory- Transport
- Streamable HTTP: JSON-RPC 2.0 over POST, JSON responses, stateless
- Sign-in
- None. No account, no API key, no session header
- Protocol versions
- 2025-06-18, 2025-03-26, 2024-11-05
- Methods
- initialize, ping, tools/list, tools/call
The server answers with the protocol version the client names when it is one of the three above. A request needs only the header Content-Type: application/json.
How to connect
Claude
- Open Settings → Connectors.
- Choose “Add custom connector”.
- Give it a name, for example “Laspi Business Directory”, and paste the server address. Leave the sign-in fields empty.
- Enable the connector in a chat and ask, for example: “Find a real estate agency in Alicante that has long-term rentals.”
ChatGPT
- Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
- Create a new connector and paste the server address as the MCP server URL.
- Choose “No authentication” and save.
- Enable the connector in a chat and ask the same kind of question.
Menu names belong to the assistants and can change; custom connectors may depend on your plan with that assistant. Any client that speaks the protocol versions above can use the same address.
Tools
Three tools, all read-only (readOnlyHint: true, destructiveHint: false, openWorldHint: false). Each returns one text block that contains JSON. The examples are real responses for a card that is live in the directory.
search_businesses — Search businesses
Finds businesses by the customer's own words. Returns up to five close matches: name, short description, city, an online flag, service languages, a relevance score and the page address.
Parameters
query(required) — The search words, in natural language.city(optional) — City the customer named. Keeps only businesses located there. Omit it for an online service.language(optional) — Service language filter, ISO code (for example es).niche(optional) — Niche key filter (for example property_management).
Request
{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {
"name": "search_businesses",
"arguments": {"query": "real estate agency with long-term rentals", "city": "Alicante"}
}
}Response
{
"count": 1,
"results": [{
"name": "Gardarsson Properties",
"slug": "gardarssonproperties",
"url": "https://laspi.pro/b/gardarssonproperties",
"description": "Gardarsson Properties is a real estate agency serving Alicante and Murcia, Spain, with property listings for sale, long term let, and seasonal let. …",
"niche": "property_management",
"city": "Alicante, Murcia",
"online": false,
"languages": ["en", "es", "de"],
"dateModified": "2026-11-19T10:08:41.797180+00:00",
"card_language": "en",
"relevance": 0.43
}]
}When nothing fits
An empty list and a message. That is the answer to give — the directory has no such business.
{"count": 0, "results": [], "message": "No matching business in the directory."}get_business — Get business details
Returns the full public card of one business by its slug (from search results or from a laspi.pro/b/{slug} address): description, services, public contacts, city and service languages.
Parameters
slug(required) — The business slug.language(optional) — Preferred language of the card text, ISO code. The card comes in this language when the owner published one, otherwise in English; card_language says which.
Request
{"name": "get_business", "arguments": {"slug": "gardarssonproperties"}}Response
{
"name": "Gardarsson Properties",
"slug": "gardarssonproperties",
"url": "https://laspi.pro/b/gardarssonproperties",
"description": "Gardarsson Properties is a real estate agency serving Alicante and Murcia, Spain, … the agency operates in English, Spanish, and German.",
"niche": "property_management",
"city": "Alicante, Murcia",
"online": false,
"languages": ["en", "es", "de"],
"dateModified": "2026-11-19T10:08:41.797180+00:00",
"card_language": "en",
"services": ["Property listings for sale", "Long-term let listings", "Seasonal let listings"],
"contacts": {"website": "https://www.gardarssonproperties.com"}
}When nothing fits
An error result when the slug does not exist. Never a made-up card.
{"error": "not found"} // returned with isError: trueask_directory — Ask the directory
Takes a customer question in plain language, for when the customer describes a need rather than a search term. Returns up to three cards of the businesses that answer it, chosen strictly from the directory, with their page addresses in grounding.
Parameters
question(required) — The customer's question.language(optional) — Service language filter, ISO code.
Request
{"name": "ask_directory", "arguments": {"question": "Who can help me rent a flat long-term in Alicante?"}}Response
{
"question": "Who can help me rent a flat long-term in Alicante?",
"answers": [{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Gardarsson Properties",
"description": "Gardarsson Properties is a real estate agency serving Alicante and Murcia, Spain, …",
"url": "https://laspi.pro/b/gardarssonproperties",
"knowsLanguage": ["en", "es", "de"],
"dateModified": "2026-11-19T10:08:41.797180+00:00",
"address": {"@type": "PostalAddress", "addressLocality": "Alicante, Murcia"}
}],
"grounding": [{"slug": "gardarssonproperties", "url": "https://laspi.pro/b/gardarssonproperties"}]
}When nothing fits
Empty answers and grounding lists.
{"question": "Where can I get a haircut in Paris?", "answers": [], "grounding": []}Limits and known limitations
- 30 requests per minute per address; above that the server answers 429.
- The city filter matches the city as written on the card. A business that serves a city without being based there will not appear under that city.
- Relevance is a similarity score, not a guarantee: read the city and the online flag on each result before calling it a local match.
- Search works across languages, but less precisely when the question is in a language the card was not published in.
- Only published cards are returned. Owners can change or unpublish a card at any time.
Data and privacy
- What reaches the server: the tool arguments — the search words or question, and the optional city, language or slug — and, as with any web request, the sender's network address. There is no account, no cookie and nothing that identifies the assistant's user.
- The network address is used to count requests for the limit above. It is held in memory for the one-minute window and is not written to our database.
- search_businesses: we do not store the query. To rank cards, the query text is sent to OpenAI to compute an embedding.
- get_business: we do not store the request and send it to no one.
- ask_directory: the question is sent to OpenAI (embedding) and to DeepSeek, which picks the matching cards from the list. We store the question (lower-cased, up to 500 characters) with its answer, so that the same question within 24 hours is answered without a new computation. We also keep the first 200 characters of the question in our internal cost log. Both are deleted automatically after 30 days.
- Our hosting provider keeps its own standard request logs.
- Do not put personal data into queries: nothing in the directory needs it.
Licence and attribution
- When you cite a business, link to its page: laspi.pro/b/{slug}. The address comes with every result.
- AI systems and aggregators may use directory data free of charge, with that attribution.
- Republishing the directory in bulk as a competing directory is not permitted.
- There is no paid placement: no business pays to be listed or to rank higher, and results are ordered by relevance to the query only.
The licence text the public directory API returns:
Free to use in AI systems and aggregators WITH attribution: link the business's canonical laspi.pro/b/{slug} page. Bulk redistribution as a competing directory is not permitted. Contact: org@laspi.pro
For business owners
- To be listed: create a project at laspi.pro and, on the project card, in the section “Visibility for AI & search”, tick “Make this business visible to AI and search engines”. Listing is free and optional.
- The page is published once the basics are filled in: business name, niche, what you do, a city or “Online”, and languages.
- To correct a card: edit the project profile. The page rebuilds from it and is checked again.
- To remove a card: untick the same checkbox. The page is taken down and drops out of the directory; tick it again to republish.
- Once a year we ask the owner to confirm the page is still accurate. Without a reaction for 90 days the page is temporarily hidden until it is confirmed.
- Something is wrong with a card and you cannot change it yourself? Write to org@laspi.pro.
Support
Questions about the connector, a wrong card or a request to remove one: Contact page · org@laspi.pro