Blog
MCP Guide

Using SwiftChronicle MCP with Claude Code, Cursor, and Windsurf

SwiftChronicle's MCP server lets your AI coding assistant query iOS 27 APIs in real time — without leaving your editor. Ask your assistant to find the Swift code for a capability, check which APIs changed in iOS 27, estimate migration effort, or list all deprecated UIKit methods. It speaks directly to the SwiftChronicle database via the Model Context Protocol.

Setup takes under two minutes in any MCP-compatible editor. Here's how.

The server requires a personal access token. Sign in and generate one for free at swiftchronicle.com/mcp, then swap it in for YOUR_TOKEN below.

What you can do

list_capabilities

Search and filter iOS 27 capabilities by category, framework, change type, or keyword

get_capability

Get full details, compilable Swift code demo, and gotchas for a specific capability

find_affected_apis

Given framework names or API symbols, find which iOS 27 capabilities are relevant

get_migration_diff

Get side-by-side before/after Swift code for updated APIs

estimate_migration

Estimate the effort and risk to adopt a capability in a given project context

Quick setup

1Claude Code

Add the following to your .claude/mcp.json (project-level) or ~/.claude/mcp.json (global):

{
  "mcpServers": {
    "swiftchronicle": {
      "type": "http",
      "url": "https://swiftchronicle.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Then restart Claude Code. The five SwiftChronicle tools will appear in /mcp.

2Cursor

Open Settings → Cursor Settings → MCP and add a new server:

Name:    SwiftChronicle
Type:    Streamable HTTP
URL:     https://swiftchronicle.com/api/mcp
Headers: Authorization: Bearer YOUR_TOKEN

Cursor will auto-discover tools on save. Ask anything in Composer with @SwiftChronicle.

3Windsurf

Open the MCP panel in Cascade and click Add Server:

Server URL: https://swiftchronicle.com/api/mcp
Transport:  Streamable HTTP
Headers:    Authorization: Bearer YOUR_TOKEN

4Zed

Zed connects over stdio, so it needs mcp-remote to bridge to our HTTP server and attach the token. In ~/.config/zed/settings.json:

{
  "context_servers": {
    "swiftchronicle": {
      "command": {
        "path": "npx",
        "args": [
          "-y", "mcp-remote", "https://swiftchronicle.com/api/mcp",
          "--header", "Authorization:Bearer YOUR_TOKEN"
        ]
      }
    }
  }
}

Example prompts

1.

List all new AI capabilities in iOS 27 that use FoundationModels

2.

Show me the Swift code for Foundation Models streaming generation

3.

What APIs changed in iOS 27 that affect my StoreKit integration?

4.

Get the before/after migration diff for App Intents in iOS 27

5.

Which deprecated APIs in iOS 27 have no direct replacement?

6.

Estimate how much work it would be to adopt RealityKit 4 in a shopping AR app

7.

Show me all Liquid Glass-related SwiftUI capabilities

View full setup instructions

The MCP page has the latest endpoint URL and editor-specific deep-links.

SwiftChronicle MCP page