FindLocal · OpenAPI Overlay 1.0.0

API Evangelist enrichment overlay for FindLocal Events API

3 actions 3 updates update extends openapi/findlocal-events-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-plansx-attributionexternalDocsx-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 Events API
  version: 1.0.0
extends: openapi/findlocal-events-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, authentication/findlocal-authentication.yml)
  and the FindLocal docs at https://findlocal.community/mcp and
  https://findlocal.community/pricing. Applies non-mutating enhancements to
  openapi/findlocal-events-api-openapi.yml.
x-rationale: >-
  The captured OpenAPI is small and clean, but the provider ships a parallel
  MCP surface and a tiered-quota pricing model that are not reflected in the
  spec. This overlay adds (1) a documented remote MCP endpoint via
  x-mcp-server on info, (2) externalDocs pointing to the provider's docs +
  llms.txt, and (3) an x-rate-limit extension on the production server
  reflecting the plan quotas. The overlay NEVER mutates the original 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
      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
      x-attribution:
        required_on_plans: [Free]
        text: Event data by FindLocal
        link: https://findlocal.community
        source: https://findlocal.community/terms#api
  - 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-events-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.