Developer Docs

Motera MCP Server

A read-only Model Context Protocol server for Motera. Connect Claude, ChatGPT, or any MCP client to search, read, and cite Motera's running guides and app information directly, without scraping HTML.

Endpoint

The server is mounted at a single endpoint and speaks streamable HTTP, the current MCP transport for remote servers. There is no server sent events endpoint and no session state, every call is a stateless JSON-RPC request.

https://www.motera.app/api/mcp

Read only, no auth requiredTransport: streamable HTTP

How to Connect

Most MCP clients, including Claude Desktop, accept a remote streamable HTTP server by URL. Add an entry like this to your client's MCP server configuration:

{
  "mcpServers": {
    "motera": {
      "url": "https://www.motera.app/api/mcp"
    }
  }
}

For stdio only clients that cannot connect to a remote URL directly, use a bridge such as mcp-remote, pointing it at the same endpoint URL above.

Available Tools

search_pages

Searches Motera's mirrored content pages by matching a query against each entry's title, path, and family. Case insensitive. Returns up to 25 matches, with a note if results were truncated.

input: { query: string }

get_page_markdown

Fetches the clean markdown mirror of one Motera page by path, for example "/running-in/london". Leading slash is optional. Returns a clear not found result if the path does not resolve.

input: { path: string }

list_running_guides

Lists Motera's pSEO running guide corpus across all families (states, cities, audiences, distances, comparisons, races, training, parkruns, trails). Optionally filter to one family.

input: { family?: string }

about_motera

Returns a clean description of the Motera app: what it does, its key features, and links to the App Store, website, and contact email.

input: (none)

What This Is For

Motera publishes hundreds of running guides covering states, cities, audiences, training plans, races, parkruns, and trails, plus app comparisons and free tools. This MCP server exposes that same content to AI assistants as structured tool calls, so an assistant can search for a topic, pull the exact markdown for a page, and answer a runner's question with a direct citation back to Motera, instead of guessing from a general web search.

Motera is a free iOS app that turns running into territory capture. Learn more or download it from the App Store.

Frequently Asked Questions

What is the Motera MCP server?

It is a read-only Model Context Protocol server that lets AI assistants like Claude and ChatGPT connect to Motera and browse, search, and cite the site's running guides and app information directly, instead of relying only on web search or scraping.

What transport does it use?

Streamable HTTP, the standard MCP transport for remote servers. There is no server sent events endpoint and no session state to manage, every tool call is a stateless request.

Does the server write any data or require authentication?

No. Every tool is a pure read over static content, there are no writes, no database access, and no authentication required to call it.

Can I use this outside of an MCP client?

The endpoint speaks MCP JSON-RPC, so it is meant for MCP clients. For a plain markdown version of any page, Motera also serves a matching .md mirror at the same path, for example motera.app/running-in/london.md.