FindLocal · OpenAPI Overlay 1.0.0

API Evangelist enrichment overlay for FindLocal Venues API

3 actions 3 updates update extends openapi/findlocal-venues-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for FindLocal's API. It is a proposal applied on top of the contract, not a document FindLocal publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-mcp-serverx-quota-plansexternalDocsx-rate-limit

Targets 3

$.info

$.servers[?(@.url == 'https://findlocal.community/api')]

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay for FindLocal Venues API
  version: 1.0.0
extends: openapi/findlocal-venues-api-openapi.yml
x-generated: '2026-11-04'
x-method: generated
x-source: >-
  Derived from the companion artifacts (mcp/findlocal-mcp.yml,
  plans/findlocal-plans-pricing.yml) and the FindLocal docs at
  https://findlocal.community/mcp and https://findlocal.community/pricing.
  Applies non-mutating enhancements to openapi/findlocal-venues-api-openapi.yml.
x-rationale: >-
  The Venues API shares the account and MCP surface with the Events API but
  the OpenAPI document does not advertise them. This overlay adds the MCP
  pointer, externalDocs and plan-quota metadata without mutating the spec.
actions:
  - target: $.info
    description: Attach FindLocal's MCP endpoint and plan-quota metadata to the spec root.
    update:
      x-mcp-server:
        url: https://mcp.findlocal.community/mcp
        transport: streamable-http
        legacy_sse: https://mcp.findlocal.community/sse
        auth: oauth2-pkce
        docs: https://findlocal.community/mcp
        crosswalk: mcp/findlocal-tool-crosswalk.yml
        related_tools: [list_venues, get_venue, get_events_at_venue, list_categories]
      x-quota-plans:
      - name: Free
        monthly_calls: 1000
        price: Free
      - name: Hobby
        monthly_calls: 10000
        price_usd: 9
        period: month
      - name: Pro
        monthly_calls: 75000
        price_usd: 49
        period: month
      - name: Enterprise
        monthly_calls: custom
        price: Contact elliot@findlocal.community
  - target: $
    description: Add externalDocs pointing to the provider's docs portal and llms.txt.
    update:
      externalDocs:
        description: FindLocal docs, playground and llms.txt
        url: https://findlocal.community/docs
        x-llms-txt: https://findlocal.community/llms.txt
  - target: $.servers[?(@.url == 'https://findlocal.community/api')]
    description: Annotate the production server with the account-scoped monthly quota.
    update:
      x-rate-limit:
        scope: account
        monthly:
          free: 1000
          hobby: 10000
          pro: 75000
        note: Shared across the REST API and the MCP server for the same key.

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/findlocal-venues-api-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.