Skip to content
Philip Ilic Thomas

MCP server

Connect Claude, ChatGPT, or another compatible AI client to search, list, and read the public writing on this site. The server is read-only and does not require an account, API key, or other authentication.

Endpoint

Add this URL as a remote Streamable HTTP MCP server. No authorization header is needed.

https://www.philipithomas.com/mcp

Tools

search(query: string)
Search public posts and site pages by subject. A natural language query must be between 2 and 300 characters. The tool returns up to ten titles, citation URLs, and stable IDs for use with fetch.
fetch(id: string)
Read the public text and metadata for one result returned by search or list_posts, capped at 50,000 characters. It accepts a site content ID, not an arbitrary URL.
list_posts(limit?: number, offset?: number, newsletter?: "contraption" | "workshop" | "postcard" | "tidbits" | "tsundoku")
List published posts in newest-first order. The default limit is 5 and the maximum is 10. Offset defaults to 0. Newsletter may be contraption, workshop, postcard, tidbits, or tsundoku; omit it to include every newsletter.

Claude

  1. In Claude on the web, open Settings, then Connectors, and choose Add custom connector. Your plan or workspace administrator may control whether custom connectors are available.
  2. Enter https://www.philipithomas.com/mcp as the remote MCP server URL and select no authentication.
  3. Connect the server, then confirm that search, fetch, and list_posts appear.

See Claude's connector testing guide for the current custom-connector flow.

Claude Code

Add the server at user scope to make it available across your Claude Code projects:

claude mcp add --transport http --scope user philipithomas https://www.philipithomas.com/mcp

Run claude mcp get philipithomas to inspect the connection, or use /mcp inside Claude Code to check its status. See the Claude Code MCP documentation for other scopes and configuration formats.

ChatGPT developer mode

  1. In ChatGPT on the web, open Settings, Apps, then Advanced settings, and enable Developer mode. A managed workspace may require an administrator to enable connected-data developer access first.
  2. Under Settings, Apps, choose Create. Enter https://www.philipithomas.com/mcp as the MCP endpoint and select no authentication.
  3. Scan the tools, confirm that search, fetch, and list_posts appear, then create and enable the app.

Availability and workspace permissions vary by ChatGPT plan. OpenAI maintains the current developer mode instructions.

Example prompts

  • “What has Philip written about building software with AI? Read the most relevant posts and cite them.”
  • “What is Philip’s latest Workshop post? Summarize it and link to the source.”
  • “Find Philip’s writing about coffee and restaurants, then compare the places he recommends.”
  • “List the five most recent posts across every newsletter.”

Troubleshooting

If the tools do not appear, confirm that the endpoint ends in /mcp, then reconnect or refresh the client’s tool list. Claude Code reports the connection under /mcp. ChatGPT provides a Scan tools action while creating the app.

The server never asks for a login. If a client presents an authentication choice, select no authentication and do not add a bearer token.

Search is rate-limited. If a search is temporarily limited, wait before trying again. For chronological questions, say “latest” or “recent” and name a newsletter when you want one publication only.

Privacy and terms

The site does not create an account or store MCP requests in its application database. The AI service you choose processes your prompt and the public content returned by these tools; semantic search may send the search query through Vercel AI Gateway to Google for an embedding. Read the MCP privacy details and terms of use, or get in touch with a question.