Rank
83
A Model Context Protocol (MCP) server for GitLab
Traction
No public download signal
Freshness
Updated 2d ago
Crawler Summary
MCP Server that dynamically generates tools from an OpenAPI specification. @openapi-mcp/server $1 $1 $1 $1 $1 $1 The openapi-mcp-server is a powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). It automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop. This enables AI assistants to seamlessly interact with your APIs, making them capable of performing real-world acti Published capability contract available. No trust telemetry is available yet. 6 GitHub stars reported by the source. Last updated 2/24/2026.
Freshness
Last checked 2/22/2026
Best For
Contract is available with explicit auth and schema references.
Not Ideal For
@openapi-mcp/server is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.
Evidence Sources Checked
editorial-content, capability-contract, runtime-metrics, public facts pack
MCP Server that dynamically generates tools from an OpenAPI specification. @openapi-mcp/server $1 $1 $1 $1 $1 $1 The openapi-mcp-server is a powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). It automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop. This enables AI assistants to seamlessly interact with your APIs, making them capable of performing real-world acti
Public facts
7
Change events
1
Artifacts
0
Freshness
Feb 22, 2026
Published capability contract available. No trust telemetry is available yet. 6 GitHub stars reported by the source. Last updated 2/24/2026.
Trust score
Unknown
Compatibility
MCP
Freshness
Feb 22, 2026
Vendor
Sotayamashita
Artifacts
0
Benchmarks
0
Last release
0.0.1
Key links, install path, and a quick operational read before the deeper crawl record.
Summary
Published capability contract available. No trust telemetry is available yet. 6 GitHub stars reported by the source. Last updated 2/24/2026.
Setup snapshot
git clone https://github.com/sotayamashita/openapi-mcp-server.gitSetup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.
Vendor
Sotayamashita
Protocol compatibility
MCP
Auth modes
mcp, api_key, oauth
Machine-readable schemas
OpenAPI or schema references published
Adoption signal
6 GitHub stars
Handshake status
UNKNOWN
Crawlable docs
6 indexed pages on the official domain
Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.
Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.
Extracted files
0
Examples
6
Snippets
0
Languages
typescript
bash
# Clone the repository git clone https://github.com/sotayamashita/openapi-mcp-server.git cd openapi-mcp-server # Install dependencies bun install
bash
# Using a local file bun run src/index.ts ./path/to/openapi.yml # Using a URL bun run src/index.ts --api https://example.com/api-spec.json
bash
# macOS/Linux code ~/Library/Application\ Support/Claude/claude_desktop_config.json
json
{
"mcpServer": {
"openapi-mcp-server": {
"command": "bun",
"args": [
"/path/to/openapi-mcp-server/src/index.ts",
"/path/to/openapi-mcp-server/demo/openapi.yml"
],
"env": {
"BASE_URL": "https://api.example.com/v1/",
"HEADERS": "{\"Authorization\": \"Bearer ****\"}"
}
}
}
}json
{
"mcpServer": {
"openapi-mcp-server": {
"command": "bun",
"args": [
"/path/to/openapi-mcp-server/src/index.ts",
"/path/to/openapi-mcp-server/demo/openapi.yml"
],
"env": {
"BASE_URL": "https://api.example.com/v1/",
"HEADERS": "{\"Authorization\": \"Bearer ****\"}"
}
}
}
}yaml
paths:
/users/{userId}:
get:
operationId: getUserById
summary: Retrieve user information
description: Returns detailed information about a specific userFull documentation captured from public sources, including the complete README when available.
Docs source
GITHUB MCP
Editorial quality
ready
MCP Server that dynamically generates tools from an OpenAPI specification. @openapi-mcp/server $1 $1 $1 $1 $1 $1 The openapi-mcp-server is a powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). It automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop. This enables AI assistants to seamlessly interact with your APIs, making them capable of performing real-world acti
The openapi-mcp-server is a powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). It automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop. This enables AI assistants to seamlessly interact with your APIs, making them capable of performing real-world actions through your services without requiring custom integrations.
โ ๏ธ Note: This server requires every operation in your OpenAPI/Swagger specification to have an
operationId. If any operation is missing anoperationId, the server will fail to start or process the specification. Always ensure that all operations are explicitly assigned a unique and descriptiveoperationId.
โ ๏ธ Version Support:
โ ๏ธ Authentication Limitations:
# Clone the repository
git clone https://github.com/sotayamashita/openapi-mcp-server.git
cd openapi-mcp-server
# Install dependencies
bun install
You can run the server by providing an OpenAPI specification URL or file path:
# Using a local file
bun run src/index.ts ./path/to/openapi.yml
# Using a URL
bun run src/index.ts --api https://example.com/api-spec.json
BASE_URL
HEADERS
{"Content-Type": "application/json","User-Agent": "openapi-mcp-server"}To use this MCP server with Claude Desktop:
Open your Claude Desktop configuration file:
# macOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Add the following configuration:
{
"mcpServer": {
"openapi-mcp-server": {
"command": "bun",
"args": [
"/path/to/openapi-mcp-server/src/index.ts",
"/path/to/openapi-mcp-server/demo/openapi.yml"
],
"env": {
"BASE_URL": "https://api.example.com/v1/",
"HEADERS": "{\"Authorization\": \"Bearer ****\"}"
}
}
}
}
For more detailed instructions, see the MCP quickstart guide.
To use this MCP server with Cursor as Global:
{
"mcpServer": {
"openapi-mcp-server": {
"command": "bun",
"args": [
"/path/to/openapi-mcp-server/src/index.ts",
"/path/to/openapi-mcp-server/demo/openapi.yml"
],
"env": {
"BASE_URL": "https://api.example.com/v1/",
"HEADERS": "{\"Authorization\": \"Bearer ****\"}"
}
}
}
}
For more detailed instructions, see the Cursor's Model Context Protocol.
operationId FieldsThe operationId field in your OpenAPI/Swagger specification plays a crucial role in how tools are presented to AI assistants. When converting your API to MCP tools:
operationId is used directly as the MCP tool nameoperationId values make it easier for AI assistants to understand and use your APIgetUser, createUser, updateUserPassword)Example of a well-defined operation:
paths:
/users/{userId}:
get:
operationId: getUserById
summary: Retrieve user information
description: Returns detailed information about a specific user
The description field for each operation is equally important:
Example of a well-described operation:
paths:
/users:
post:
operationId: createUser
summary: Create a new user account
description: |
Creates a new user in the system. Requires a unique email address and a
password that meets security requirements (min 8 chars, including uppercase,
lowercase, number). Returns the created user object with an assigned user ID.
Without thorough descriptions, AI assistants may struggle to identify the right operations for user requests or may use them incorrectly. The quality of your API descriptions directly impacts how effectively AI can leverage your tools.
# Run tests
bun vitest run
# Run tests with watch mode
bun vitest
# Run tests with coverage
bun vitest run --coverage
# Format code
bun prettier . --write
This section outlines the manual steps for creating a new release using a dedicated release branch. This method helps isolate the release process from the main branch until publication.
Prerequisites:
main branch.npm login).bunx).Steps:
Ensure main is up-to-date:
git checkout main
git pull origin main
Create a release branch: Name it according to the version you intend to release (e.g., v0.1.0).
git checkout -b release/vX.Y.Z main
Replace vX.Y.Z with the target version.
Bump versions and update Changelog: This command consumes the changeset files (in .changeset/), updates the version in package.json, and updates CHANGELOG.md.
bunx @changesets/cli version
Review the changes applied to package.json and CHANGELOG.md to ensure they are correct.
Commit the versioning changes:
git add .
git commit -m "chore: update versions and changelogs for vX.Y.Z"
Replace vX.Y.Z with the target version.
Build the project: Ensure the distribution files are generated with the latest changes.
bun run build
Publish to npm: Publish the new version to the npm registry.
npm publish
Ensure your package.json includes "publishConfig": { "access": "public" } for scoped public packages.
(You might also use bun publish, but confirm its behavior with scoped public packages if you choose this.)
Tag the release in Git: Create a Git tag that matches the version published to npm.
# Replace X.Y.Z with the actual version number, e.g., 0.1.0
git tag @openapi-mcp/server@X.Y.Z
Merge the release branch back into main: This brings the version bump and CHANGELOG updates into your main branch.
git checkout main
git merge --no-ff release/vX.Y.Z
(Using --no-ff creates a merge commit, which can help in tracking releases in the Git history).
Push main and the new tag to the remote repository:
git push origin main --tags
(Optional) Clean up: Delete the release branch locally and remotely if it's no longer needed.
git branch -d release/vX.Y.Z
git push origin --delete release/vX.Y.Z
For more detailed information on using Changesets, refer to the official Changesets documentation.
Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.
Contract coverage
Status
ready
Auth
mcp, api_key, oauth
Streaming
No
Data region
global
Protocol support
Requires: mcp, lang:typescript
Forbidden: none
Guardrails
Operational confidence: medium
curl -s "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/snapshot"
curl -s "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract"
curl -s "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/trust"
Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.
Trust signals
Handshake
UNKNOWN
Confidence
unknown
Attempts 30d
unknown
Fallback rate
unknown
Runtime metrics
Observed P50
unknown
Observed P95
unknown
Rate limit
unknown
Estimated cost
unknown
Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.
Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.
Rank
83
A Model Context Protocol (MCP) server for GitLab
Traction
No public download signal
Freshness
Updated 2d ago
Rank
80
A Model Context Protocol (MCP) server for GitLab
Traction
No public download signal
Freshness
Updated 2d ago
Rank
74
Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)
Traction
No public download signal
Freshness
Updated 2d ago
Rank
72
An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)
Traction
No public download signal
Freshness
Updated 2d ago
Contract JSON
{
"contractStatus": "ready",
"authModes": [
"mcp",
"api_key",
"oauth"
],
"requires": [
"mcp",
"lang:typescript"
],
"forbidden": [],
"supportsMcp": true,
"supportsA2a": false,
"supportsStreaming": false,
"inputSchemaRef": "https://github.com/sotayamashita/openapi-mcp-server#input",
"outputSchemaRef": "https://github.com/sotayamashita/openapi-mcp-server#output",
"dataRegion": "global",
"contractUpdatedAt": "2026-02-24T19:46:42.640Z",
"sourceUpdatedAt": "2026-02-24T19:46:42.640Z",
"freshnessSeconds": 4444872
}Invocation Guide
{
"preferredApi": {
"snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/snapshot",
"contractUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract",
"trustUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/trust"
},
"curlExamples": [
"curl -s \"https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/snapshot\"",
"curl -s \"https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract\"",
"curl -s \"https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/trust\""
],
"jsonRequestTemplate": {
"query": "summarize this repo",
"constraints": {
"maxLatencyMs": 2000,
"protocolPreference": [
"MCP"
]
}
},
"jsonResponseTemplate": {
"ok": true,
"result": {
"summary": "...",
"confidence": 0.9
},
"meta": {
"source": "GITHUB_MCP",
"generatedAt": "2026-04-17T06:27:55.200Z"
}
},
"retryPolicy": {
"maxAttempts": 3,
"backoffMs": [
500,
1500,
3500
],
"retryableConditions": [
"HTTP_429",
"HTTP_503",
"NETWORK_TIMEOUT"
]
}
}Trust JSON
{
"status": "unavailable",
"handshakeStatus": "UNKNOWN",
"verificationFreshnessHours": null,
"reputationScore": null,
"p95LatencyMs": null,
"successRate30d": null,
"fallbackRate": null,
"attempts30d": null,
"trustUpdatedAt": null,
"trustConfidence": "unknown",
"sourceUpdatedAt": null,
"freshnessSeconds": null
}Capability Matrix
{
"rows": [
{
"key": "MCP",
"type": "protocol",
"support": "supported",
"confidenceSource": "contract",
"notes": "Confirmed by capability contract"
},
{
"key": "openapi",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "swagger",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "oas",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "mcp",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "model-context-protocol",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "server",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "tool",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "bridge",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "cli",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "api",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "ai",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
},
{
"key": "llm",
"type": "capability",
"support": "supported",
"confidenceSource": "profile",
"notes": "Declared in agent profile metadata"
}
],
"flattenedTokens": "protocol:MCP|supported|contract capability:openapi|supported|profile capability:swagger|supported|profile capability:oas|supported|profile capability:mcp|supported|profile capability:model-context-protocol|supported|profile capability:server|supported|profile capability:tool|supported|profile capability:bridge|supported|profile capability:cli|supported|profile capability:api|supported|profile capability:ai|supported|profile capability:llm|supported|profile"
}Facts JSON
[
{
"factKey": "docs_crawl",
"category": "integration",
"label": "Crawlable docs",
"value": "6 indexed pages on the official domain",
"href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
"sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
"sourceType": "search_document",
"confidence": "medium",
"observedAt": "2026-04-15T05:03:46.393Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "MCP",
"href": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract",
"sourceUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract",
"sourceType": "contract",
"confidence": "high",
"observedAt": "2026-02-24T19:46:42.640Z",
"isPublic": true
},
{
"factKey": "auth_modes",
"category": "compatibility",
"label": "Auth modes",
"value": "mcp, api_key, oauth",
"href": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract",
"sourceUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract",
"sourceType": "contract",
"confidence": "high",
"observedAt": "2026-02-24T19:46:42.640Z",
"isPublic": true
},
{
"factKey": "schema_refs",
"category": "artifact",
"label": "Machine-readable schemas",
"value": "OpenAPI or schema references published",
"href": "https://github.com/sotayamashita/openapi-mcp-server#input",
"sourceUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/contract",
"sourceType": "contract",
"confidence": "high",
"observedAt": "2026-02-24T19:46:42.640Z",
"isPublic": true
},
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Sotayamashita",
"href": "https://github.com/sotayamashita/openapi-mcp-server",
"sourceUrl": "https://github.com/sotayamashita/openapi-mcp-server",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-02-24T19:43:14.176Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "6 GitHub stars",
"href": "https://github.com/sotayamashita/openapi-mcp-server",
"sourceUrl": "https://github.com/sotayamashita/openapi-mcp-server",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-02-24T19:43:14.176Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/trust",
"sourceUrl": "https://xpersona.co/api/v1/agents/mcp-sotayamashita-openapi-mcp-server/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
]Change Events JSON
[
{
"eventType": "docs_update",
"title": "Docs refreshed: Sign in to GitHub ยท GitHub",
"description": "Fresh crawlable documentation was indexed for the official domain.",
"href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
"sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
"sourceType": "search_document",
"confidence": "medium",
"observedAt": "2026-04-15T05:03:46.393Z",
"isPublic": true
}
]Sponsored
Ads related to @openapi-mcp/server and adjacent AI workflows.