Laspi Pro
How it worksPricingFreeContent for websitesBlog
Try it free

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

  1. Open Settings → Connectors.
  2. Choose “Add custom connector”.
  3. Give it a name, for example “Laspi Business Directory”, and paste the server address. Leave the sign-in fields empty.
  4. Enable the connector in a chat and ask, for example: “Find a real estate agency in Alicante that has long-term rentals.”

ChatGPT

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Create a new connector and paste the server address as the MCP server URL.
  3. Choose “No authentication” and save.
  4. 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: true

ask_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.

Privacy policy · Terms of use

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

Laspi Pro

Laspi Pro, your virtual co-author: tell it what's new and get posts, articles and visibility in Google and ChatGPT.

org@laspi.pro
ProductHow it worksPricingWho it's forInstall the appFor teamsContent for websitesSMM manager costWhat to compare LaspiPro withFree AI-text checkFree AI-visibility check
For your businessBeauty salonsRestaurants & cafésReal estatePhotographersPsychologistsDental clinicsArtisans & makersCoachesDoctors in private practiceFitness trainersTutors & educatorsDigital freelancersProduct brandsInfluencers & creatorsMusicians & artistsFinancial advisorsEvent plannersHome bakersBakeriesPhysiotherapistsFloristsWomen in techMar Menor businesses
CompanyAboutBlogFAQContact★ Trustpilot★ Google
LegalTrust & SecurityPrivacyCookiesTermsImprint
Laspi Pro is a product of GradeBuilder S.L. · Santiago de la Ribera, Murcia, Spain · ENISA-certified startup under Ley 28/2022© 2026 LaspiPro — Laspi.Pro · by GradeBuilder S.L. · All rights reserved. EN · ES · RU · IT

We use essential cookies to run Laspi Pro, and analytics/marketing cookies only with your consent. Cookie Policy