{"id":51549500,"url":"https://github.com/ory/mcp","last_synced_at":"2026-07-09T22:30:36.636Z","repository":{"id":294258811,"uuid":"985997829","full_name":"ory/mcp","owner":"ory","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-02T17:26:21.000Z","size":21034,"stargazers_count":6,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-08T06:34:36.459Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"patreon":"_ory","open_collective":"ory"}},"created_at":"2025-05-19T00:19:36.000Z","updated_at":"2025-07-02T17:27:02.000Z","dependencies_parsed_at":"2025-05-19T16:42:36.213Z","dependency_job_id":"ce195210-1db4-4638-bc91-9df919ccaa48","html_url":"https://github.com/ory/mcp","commit_stats":null,"previous_names":["ory/mcp-oauth-provider","ory/mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ory/mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ory%2Fmcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ory%2Fmcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ory%2Fmcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ory%2Fmcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ory","download_url":"https://codeload.github.com/ory/mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ory%2Fmcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35314872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-09T22:30:35.206Z","updated_at":"2026-07-09T22:30:36.628Z","avatar_url":"https://github.com/ory.png","language":"TypeScript","funding_links":["https://patreon.com/_ory","https://opencollective.com/ory"],"categories":[],"sub_categories":[],"readme":"# Ory MCP (Model Context Protocol)\n\nThis repository contains TypeScript packages for integrating Ory authentication and access control with the Model Context Protocol (MCP). The repository has been renamed from `mcp-oauth-provider` to `mcp` to be inclusive of all Ory MCP projects.\n\n## Packages\n\n### @ory/mcp-oauth-provider\n\nA TypeScript implementation of an OAuth provider for Ory MCP that supports both Ory Network and Ory Hydra as backend providers. This package provides seamless integration between MCP servers and Ory's OAuth2.1 authentication system.\n\n**Key Features:**\n\n- Supports both Ory Network and Ory Hydra as backend providers\n- Handles OAuth2 authorization code flow with PKCE\n- Manages client registration and token operations\n- Provides token introspection and verification\n- Integrates seamlessly with MCP server authentication\n\n**Installation:**\n\n```bash\nnpm install @ory/mcp-oauth-provider\n```\n\nFor detailed documentation and usage examples, see the [package README](./packages/mcp-oauth-provider/README.md).\n\n### @ory/mcp-access-control\n\nA TypeScript module that provides MCP tool definitions for Ory Network access control integration. This module helps validate JWT tokens, create/retrieve Ory identities, and manage authentication sessions.\n\n**Key Features:**\n\n- JWT token validation using JWKS\n- Configurable JWT audience and claim extraction\n- Automatic identity creation/retrieval in Ory Network\n- Password-based authentication with session management\n- Session token validation for MCP middleware\n- MCP tool definition generation\n\n**Installation:**\n\n```bash\nnpm install @ory/mcp-access-control\n```\n\nFor detailed documentation and usage examples, see the [package README](./packages/mcp-access-control/README.md).\n\n## Examples\n\n### OAuth Provider Example\n\nThe `examples/oauth-provider-example/` directory contains a complete MCP server implementation that demonstrates how to use the `@ory/mcp-oauth-provider` package with Ory Network authentication.\n\n**Features demonstrated:**\n\n- Complete MCP server setup with Ory OAuth2.1 authentication\n- Bearer token authentication middleware\n- Project management tools\n- Both Streamable HTTP and SSE transport support\n\n**Getting Started:**\n\n1. Set up your environment variables:\n\n   ```bash\n   ORY_PROJECT_URL=https://your-project.projects.oryapis.com\n   ORY_PROJECT_API_KEY=your-api-key\n   MCP_BASE_URL=http://localhost:3000\n   SERVICE_DOCUMENTATION_URL=https://your-docs-url.com\n   ```\n\n2. Run the example server:\n   ```bash\n   cd examples/oauth-provider-example\n   npm install\n   npm start\n   ```\n\nFor the complete implementation, see [examples/oauth-provider-example/mcp-server.ts](./examples/oauth-provider-example/mcp-server.ts).\n\n## Repository History\n\nThis repository was originally named `mcp-oauth-provider` and focused solely on OAuth provider functionality. It has been renamed to `mcp` to better reflect its expanded scope as a collection of Ory MCP integration packages. The original `mcp-oauth-provider` package can still be found in the `packages/mcp-oauth-provider/` directory.\n\n## Development\n\n### Prerequisites\n\n- Node.js 18+\n- npm or yarn\n\n### Workspace Management\n\nThis repository uses pnpm workspaces to manage the monorepo structure. The workspace includes both packages and examples.\n\n#### Prerequisites\n\n- Node.js 18+\n- pnpm 8+\n\n#### Installation\n\nInstall all dependencies across all packages and examples:\n\n```bash\npnpm install\n```\n\n#### Building\n\nBuild all packages:\n\n```bash\npnpm build\n```\n\nOr build a specific package:\n\n```bash\npnpm --filter @ory/mcp-oauth-provider build\npnpm --filter @ory/mcp-access-control build\n```\n\n#### Testing\n\nRun tests for all packages:\n\n```bash\npnpm test\n```\n\nOr test a specific package:\n\n```bash\npnpm --filter @ory/mcp-oauth-provider test\npnpm --filter @ory/mcp-access-control test\n```\n\n#### Linting and Formatting\n\nLint all packages:\n\n```bash\npnpm lint\npnpm lint:fix\n```\n\nFormat all packages:\n\n```bash\npnpm format\npnpm format:check\n```\n\n#### Development\n\nRun development mode for all packages (if available):\n\n```bash\npnpm dev\n```\n\n#### Legacy Commands\n\nIf you prefer to work with individual packages directly:\n\n```bash\n# Build mcp-oauth-provider\ncd packages/mcp-oauth-provider\nnpm install\nnpm run build\n\n# Build mcp-access-control\ncd ../mcp-access-control\nnpm install\nnpm run build\n\n# Test mcp-oauth-provider\ncd packages/mcp-oauth-provider\nnpm test\n\n# Test mcp-access-control\ncd ../mcp-access-control\nnpm test\n```\n\n## Contributing\n\nWe welcome contributions! Please see the individual package directories for specific contribution guidelines.\n\n## License\n\nCopyright 2025 Ory Corp\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fory%2Fmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fory%2Fmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fory%2Fmcp/lists"}