# systemprompt.io

> Production infrastructure for AI agents powered by Anthropic Claude, OpenAI ChatGPT, and Google Gemini. Self-hosted Rust platform with MCP server hosting, OAuth security, multi-provider orchestration, and enterprise observability.

systemprompt.io enables teams to deploy production AI applications using Anthropic's Claude, OpenAI's ChatGPT, and Google's Gemini through a unified infrastructure layer. Native SDK integration with all three providers supports automatic failover, cost optimization, and smart model routing. Built on the Model Context Protocol (MCP) standard—pioneered by Anthropic for Claude Desktop—systemprompt.io delivers production-grade tool serving compatible with the leading AI assistants.

## Quick Links

- Homepage: https://systemprompt.io
- Documentation: https://systemprompt.io/documentation
- Guides: https://systemprompt.io/guides
- GitHub: https://github.com/systempromptio/systemprompt-template

## Key Features

- **MCP Server Hosting**: Production OAuth-secured Model Context Protocol servers compatible with Claude Desktop and AI coding assistants
- **Multi-Provider AI**: Native integration with Anthropic Claude, OpenAI ChatGPT, and Google Gemini with automatic failover
- **Agent Orchestration**: A2A protocol for agent-to-agent communication across AI providers
- **Enterprise Security**: OAuth2/OIDC + WebAuthn passwordless authentication
- **Full Observability**: Request tracing, cost tracking per provider, audit logs
- **Rust Extension System**: Type-safe traits for API routes, jobs, schemas, and providers

## AI Provider Integrations

systemprompt.io supports multiple AI providers with native SDK integration:

- **Anthropic Claude**: Native Claude API integration with Claude Sonnet 4, Claude Opus 4, and Claude Haiku support. Full MCP protocol compatibility for tool serving.
- **OpenAI ChatGPT**: GPT-4o and GPT-4 Turbo integration with function calling and structured outputs.
- **Google Gemini**: Gemini Pro and Gemini Flash support with search grounding capabilities.

Smart routing automatically selects the optimal model based on task complexity, cost constraints, and availability.

## Documentation

Technical reference for SystemPrompt architecture and APIs.

### Services

- [AI Services](https://systemprompt.io/documentation/services/ai): Configure and manage AI providers in systemprompt.io. Supports Anthropic, OpenAI, and Google Gemini with streaming, web search grounding, image generation, smart routing, and MCP tool integration.
- [Agent Services](https://systemprompt.io/documentation/services/agents): Configure and orchestrate AI agents with A2A protocol support, skills-based capabilities, multi-agent workflows, and OAuth security. Agents are the AI workers that perform tasks in systemprompt.io.
- [Analytics Service](https://systemprompt.io/documentation/services/analytics): Automatic tracking of AI costs, usage metrics, session engagement, content performance, and audit trails. Every request logged with full observability.
- [Authentication](https://systemprompt.io/documentation/services/auth): OAuth2/OIDC authorization, WebAuthn passwordless login, magic link authentication, JWT token lifecycle, and session management built into every layer of systemprompt.io.
- [Config Service](https://systemprompt.io/documentation/services/config): The config service aggregates all service configurations into a unified hub, managing includes, global settings, and startup validation.
- [Content Service](https://systemprompt.io/documentation/services/content): Manage blog posts, documentation, and legal pages with markdown authoring, YAML frontmatter, automatic indexing, and built-in SEO. The content service ingests files, stores them in PostgreSQL, and generates sitemaps, RSS feeds, and llms.txt.
- [Files Service](https://systemprompt.io/documentation/services/files): Three-layer file storage with local and S3 backends, permission-scoped access, upload handling, and CDN-ready serving for AI workloads.
- [MCP Service -- Host and Manage MCP Servers](https://systemprompt.io/documentation/services/mcp): Host production MCP servers with OAuth authentication, tool discovery, capability negotiation, and streamable HTTP transport. Integrate with Claude Desktop, Claude Code, and any MCP-compatible client.
- [Scheduled Jobs](https://systemprompt.io/documentation/services/scheduler): Run background jobs on cron schedules for content publishing, analytics aggregation, session cleanup, database maintenance, and custom automation tasks.
- [Services](https://systemprompt.io/documentation/services): Configure and manage the runtime components that power your systemprompt.io instance - agents, skills, MCP servers, content, AI, scheduled jobs, and web interface.
- [Skills Service](https://systemprompt.io/documentation/services/skills): Define reusable agent capabilities through skills. Skills provide tagged, discoverable actions that multiple agents can share.
- [Skills Service](https://systemprompt.io/documentation/services/playbooks): Skills define reusable agent capabilities in systemprompt.io. They replace the former playbooks system with structured YAML definitions.
- [Users](https://systemprompt.io/documentation/services/users): Per-user isolation from day one. User scopes enforced automatically across all operations.
- [Web Service](https://systemprompt.io/documentation/services/web): Reference for the web service that renders pages, manages templates, serves assets, and controls the entire presentation layer of a systemprompt.io application.
- [Workflows](https://systemprompt.io/documentation/services/workflows): Define once, execute anywhere. Skills and multi-agent orchestration provide YAML-based automation that both humans and AI agents can run through CLI, MCP, or scheduled jobs.

### Extensions

- [API Extension](https://systemprompt.io/documentation/extensions/traits/api-extension): Add HTTP routes and API endpoints to your extension.
- [Asset Declaration](https://systemprompt.io/documentation/extensions/web-traits/asset-declaration): Declare CSS, JavaScript, fonts, and images for your extension.
- [CLI Extensions](https://systemprompt.io/documentation/extensions/domains/cli): Build standalone CLI extensions for custom commands, external integrations, and utility tools that agents can execute via subprocess.
- [Component Renderers](https://systemprompt.io/documentation/extensions/web-traits/component-renderer): Create ComponentRenderer implementations to generate HTML fragments for your templates.
- [Config Extension](https://systemprompt.io/documentation/extensions/traits/config-extension): Add configuration namespaces and validation to your extension.
- [Content Data Provider](https://systemprompt.io/documentation/extensions/web-traits/content-data-provider): Enrich content items with computed fields, related content, and database lookups.
- [Error Handling](https://systemprompt.io/documentation/extensions/internals/error-handling): Error types for extension loading, configuration, and runtime.
- [Extension Builder](https://systemprompt.io/documentation/extensions/internals/extension-builder): Type-safe extension registration with compile-time dependency checking.
- [Extension Dependencies](https://systemprompt.io/documentation/extensions/lifecycle/dependencies): Declare and manage dependencies between extensions.
- [Extension Discovery](https://systemprompt.io/documentation/extensions/lifecycle/discovery): How the runtime discovers and validates extensions at startup.
- [Extension Initialization](https://systemprompt.io/documentation/extensions/lifecycle/initialization): How extensions integrate with AppContext during runtime startup.
- [Extension Registration](https://systemprompt.io/documentation/extensions/lifecycle/registration): How extensions register with the runtime using the inventory crate and register_extension! macro.
- [Extension Trait Reference](https://systemprompt.io/documentation/extensions/traits/extension-trait): Complete reference for the Extension trait with all 30+ methods for database, API, jobs, providers, and web rendering.
- [Extensions and Scoped Permissions](https://systemprompt.io/documentation/extensions): How systemprompt.io extensions work across four domains, and how permission scoping enforces per-agent, per-tool authorization through OAuth2, roles, and access control rules.
- [Frontmatter Processor](https://systemprompt.io/documentation/extensions/web-traits/frontmatter-processor): Parse custom frontmatter fields during content ingestion.
- [Job Extension](https://systemprompt.io/documentation/extensions/traits/job-extension): Add background jobs and scheduled tasks to your extension.
- [Library Extensions](https://systemprompt.io/documentation/extensions/domains/library): Build library extensions that compile into the main binary: API routes, database schemas, background jobs, and providers.
- [MCP Extensions](https://systemprompt.io/documentation/extensions/domains/mcp): Build standalone MCP server extensions that expose tools for AI agents via the Model Context Protocol.
- [MCP Resources](https://systemprompt.io/documentation/extensions/mcp/resources): Implementing MCP resources and templates for exposing data and UI artifacts to clients.
- [MCP Response Patterns](https://systemprompt.io/documentation/extensions/mcp/responses): Best practices for returning tool results with both human-readable and structured content.
- [MCP Server AI Integration](https://systemprompt.io/documentation/extensions/mcp-ai-integration): Complete guide to integrating AI services (Gemini, Anthropic, OpenAI) into MCP servers with search grounding and artifact persistence.
- [MCP Skill Integration](https://systemprompt.io/documentation/extensions/mcp/skills): Loading and using skills in MCP servers for AI-powered tool implementations.
- [MCP Tool Structure](https://systemprompt.io/documentation/extensions/mcp/tool-structure): Detailed reference for organizing tools with modular directory patterns, handler signatures, and schema definitions.
- [Page Data Providers](https://systemprompt.io/documentation/extensions/web-traits/page-data-provider): Create PageDataProvider implementations to provide ALL template variables for your pages.
- [Page Prerenderer](https://systemprompt.io/documentation/extensions/web-traits/page-prerenderer): Generate static HTML pages at build time for list pages, index pages, and configured content.
- [Provider Extension](https://systemprompt.io/documentation/extensions/traits/provider-extension): Add LLM and tool providers to your extension.
- [RSS & Sitemap Providers](https://systemprompt.io/documentation/extensions/web-traits/rss-sitemap-provider): Generate RSS feeds and sitemap entries for your content.
- [Schema Extension](https://systemprompt.io/documentation/extensions/traits/schema-extension): Add database schemas and migrations to your extension.
- [Template Data Extender](https://systemprompt.io/documentation/extensions/web-traits/template-data-extender): Make final modifications to template data after all providers and renderers have run.
- [Typed Extensions](https://systemprompt.io/documentation/extensions/internals/typed-extensions): Compile-time type-safe extension traits for schema, API, job, provider, and config extensions.
- [Web Extensions](https://systemprompt.io/documentation/extensions/domains/web): Build web extensions for page data, static generation, templates, and asset management.

### Configuration Reference

- [Cloud Credentials](https://systemprompt.io/documentation/config/credentials): Cloud API authentication credentials, token management, and login workflow.
- [Code Sync](https://systemprompt.io/documentation/config/sync): Synchronize configuration between local development and systemprompt.io Cloud. Push, pull, and resolve conflicts.
- [Configuration & Credentials](https://systemprompt.io/documentation/config): How credentials management works in .systemprompt/ - sessions, tenants, profiles, secrets, and cloud deployment.
- [Custom Domains](https://systemprompt.io/documentation/config/domains): Configure custom domains for systemprompt.io Cloud with automatic TLS certificates via Let's Encrypt.
- [Database](https://systemprompt.io/documentation/config/database): Configure PostgreSQL database connection for systemprompt.io. One connection string is all you need.
- [Deployment](https://systemprompt.io/documentation/config/deployment): Deploy AI agents to systemprompt.io Cloud with a single command. CI/CD integration, zero-downtime deployments, and rollback strategies.
- [Docker Configuration](https://systemprompt.io/documentation/config/docker): Docker serves two purposes in systemprompt.io: running PostgreSQL locally and deploying your application to production.
- [Paths Configuration](https://systemprompt.io/documentation/config/paths): Directory paths for system files, services, binaries, and optional storage.
- [Profiles](https://systemprompt.io/documentation/config/profiles): Environment configurations for systemprompt.io. Each profile contains all settings needed to run in a specific environment.
- [Rate Limits](https://systemprompt.io/documentation/config/rate-limits): API request throttling with per-endpoint limits and user tier multipliers.
- [Runtime Configuration](https://systemprompt.io/documentation/config/runtime): Environment type, logging levels, output format, and interactive mode settings.
- [Secrets & Credentials](https://systemprompt.io/documentation/config/secrets): Manage API keys, credentials, and sensitive configuration for local development and cloud deployments.
- [Security Configuration](https://systemprompt.io/documentation/config/security): JWT token settings including issuer, expiration times, and audience configuration.
- [Server Configuration](https://systemprompt.io/documentation/config/server): HTTP server settings including host, port, API URLs, CORS, and HTTPS.
- [Sessions](https://systemprompt.io/documentation/config/sessions): CLI authentication state and profile switching. Sessions track which profile is active and authenticate your requests.
- [Tenants](https://systemprompt.io/documentation/config/tenants): Isolated environments for systemprompt.io. Local tenants run on your machine, cloud tenants run on managed infrastructure.

### General

- [Coding Standards](https://systemprompt.io/documentation/coding-standards): Rust coding standards for systemprompt.io - idiomatic patterns, mandatory requirements, and anti-patterns to avoid
- [Connect MCP Servers](https://systemprompt.io/documentation/guides/connect-mcp): Connect Claude Code, ChatGPT, and other AI clients to your systemprompt MCP servers. OAuth-secured tool access with full audit trail.
- [Database Service](https://systemprompt.io/documentation/database): Database access patterns in Rust code - connecting to PostgreSQL, using repositories, and accessing the pool in different contexts
- [Deploy as a Website](https://systemprompt.io/documentation/guides/deploy-website): Deploy your systemprompt template to production with user authentication, custom domains, and SSL. Ship your AI agents to real users.
- [Early Access](https://systemprompt.io/documentation/early-access): systemprompt.io is in open early access. Expect quirks—we're committed to fixing every bug and vulnerability you report.
- [Guides](https://systemprompt.io/documentation/guides): Step-by-step guides to get the most out of your systemprompt.io installation.
- [Installation](https://systemprompt.io/documentation/installation): Clone the systemprompt-template to get a complete running Rust binary with A2A agents, MCP servers, and a static-generated homepage ready to extend.
- [Licensing](https://systemprompt.io/documentation/licensing): Understand how systemprompt.io licensing works: the core is BSL-1.1, the template is MIT and fully yours.
- [Skills](https://systemprompt.io/documentation/playbooks): Skills are reusable, discoverable capabilities that define what agents can do. They replace the former playbook system with structured YAML-based definitions.
- [Talk to Your Agents](https://systemprompt.io/documentation/guides/talk-to-me): Send HTTP messages to your systemprompt agents and see them respond in real-time. Learn the CLI commands and HTTP endpoints for agent communication.

## Guides

Articles on AI agent development and SystemPrompt features.

- [Get Started with the Anthropic Marketplace Plugin System](https://systemprompt.io/guides/getting-started-anthropic-marketplace): Install your first plugin from the Anthropic Marketplace in Claude Cowork, configure it with systemprompt.io skills, and start using AI that knows your business.

## Resources

- [GitHub Repository](https://github.com/systempromptio/systemprompt-template): Clone to start building
- [Sitemap](https://systemprompt.io/sitemap.xml): Complete URL index for crawling
- [All Documentation](https://systemprompt.io/documentation): Browse all documentation