llms.txt@public git:20261009.879881eA

Immutable. This exact content never changes and is served at /api/v1/blob/3a4db4a2ded785aa.

# Apple RAG MCP

> Official Apple developer documentation and WWDC video transcripts for your AI agents, with RAG retrieval and Jev relevance ranking.

## Why Developers Love Apple RAG MCP

**Lightning Fast**: Get instant responses with our optimized search infrastructure. No more hunting through docs.

**Powered by [Jev](https://typesafe.ai/)**: RAG combines semantic and keyword retrieval to find candidate sources. Jev scores them against your question's API, platform, and version requirements. Its relevance scores determine the order of the sources returned through MCP. A backup reranker takes over if the API call fails; your agent uses the sources to write its answer.

**Always Secure**: MCP authentication ensures trusted access for your AI agents with enterprise-grade security.

**Code Examples**: Get practical code examples in Swift, Objective-C, and SwiftUI alongside documentation references.

**Regular Updates**: Our collector checks official Apple documentation and video transcripts for new and updated content.

**Comprehensive Knowledge Base**: Multiple data sources, one search - from official documentation to WWDC26 video transcripts, all accessible through our unified MCP interface.

## Open Source. Ready to Use.

The [hosted service](https://apple-rag.com/) provides an Apple knowledge base that is already collected, cleaned, and indexed. Retrieval model calls, including embeddings and [Jev](https://typesafe.ai/) ranking, run on our service. We handle content collection, index updates, database backups, and protocol compatibility.

The source is public for inspection and self-hosting. Self-hosting requires operating your own database, building and updating your corpus, and managing model API credentials.

## Quick Setup for AI Agents

Copy the install prompt from the [dashboard](https://apple-rag.com/overview) and paste it into your current agent to configure the connection and verify the tools.

The following JSON is a configuration example, not a universal client format. Use the native format supported by your client.

**Basic Configuration (Try Without Registration)**:
```json
{
  "mcpServers": {
    "apple-rag-mcp": {
      "type": "http",
      "url": "https://mcp.apple-rag.com"
    }
  }
}
```

**Enhanced Configuration (With Authentication)**:
```json
{
  "mcpServers": {
    "apple-rag-mcp": {
      "type": "http",
      "url": "https://mcp.apple-rag.com",
      "headers": {
        "Authorization": "Bearer your-mcp-token-here"
      }
    }
  }
}
```

**Free Account**: Register at [apple-rag.com](https://apple-rag.com/) and configure your MCP Token for 50 tool calls per week and 5 per minute. Upgrade to [Pro](https://apple-rag.com/#pricing) for 50,000 tool calls per week and 50 per minute.

## Manual Configuration Parameters

For MCP clients that don't support JSON import:

**Required Settings**:
- **Name**: `apple-rag-mcp`
- **MCP Type**: `Streamable HTTP`
- **URL (Endpoint)**: `https://mcp.apple-rag.com`
- **Protocol Version**: `2026-07-28`

The client must support protocol `2026-07-28`. Writing a configuration alone does not verify a working connection.

**Optional Authentication** (for registered users):
- **Authentication Type**: `API key / Token`
- **API key / Token**: `your-mcp-token-here`
- **Authorization Header**: `Bearer your-mcp-token-here`

## Authentication Options

**No Registration Required**: Start with 30 tool calls per week and 3 per minute
**MCP Tokens**: Register for 50 tool calls per week and 5 per minute; Pro includes 50,000 per week and 50 per minute
**IP Authentication**: Authorize your IP addresses for automatic authentication without needing tokens

## Available MCP Tools

- **search**: Search official Apple developer documentation and WWDC video transcripts using hybrid RAG retrieval and Jev relevance ranking. Returns ranked source excerpts; use fetch for complete page content.
- **fetch**: Retrieve complete cleaned content for specific Apple developer documentation or video by URL.

## Pricing & Benefits

**Anonymous**: 30 tool calls per week, 3 per minute
**Free Account**: 50 tool calls per week, 5 per minute
**Pro**: $1/week - 50,000 tool calls per week, 50 per minute, multiple MCP tokens and usage analytics
**Enterprise**: [Contact us](https://apple-rag.com/#pricing) to discuss your team's requirements

The weekly and per-minute quotas are shared by search and fetch. All search tiers use RAG retrieval and Jev as the primary relevance ranker.

**Setup Options**: The dashboard provides one-click install links and an install prompt for your current agent. Verify protocol compatibility and test both search and fetch after configuration.

## Get Started Now

- [Apple RAG Website](https://apple-rag.com): Register for free and upgrade for premium features
- [User Dashboard](https://apple-rag.com/overview): Manage tokens, view usage analytics, and account settings
- [MCP Token Management](https://apple-rag.com/mcp-tokens): Create and manage authentication tokens for your AI agents
- [Authorized IPs](https://apple-rag.com/authorized-ips): Configure IP addresses for automatic authentication without tokens
- [Usage Analytics](https://apple-rag.com/usage): Monitor your API usage and performance metrics
- [GitHub Repository](https://github.com/BingoWon/apple-rag-mcp): Star us and see why developers are making this a core part of their stack

## Optional

- [Main README](https://github.com/BingoWon/apple-rag-mcp/blob/main/README.md): Complete technical documentation and setup instructions