mcp-connections

Connect, catalog, and debug MCP servers for agent tool access.

49|11|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/vstorm-co/agenticos --skill mcp-connections-vstorm-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-connections
Source: https://github.com/vstorm-co/agenticos/tree/main/.claude/skills/mcp-connections
Command: npx skills add https://github.com/vstorm-co/agenticos --skill mcp-connections-vstorm-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents often need tools from external SaaS products like GitHub, Linear, Notion, Slack, Stripe, or Postgres, and developers struggle with questions like why the agent cannot see MCP tools, why an OAuth flow fails, or whether to write a custom capability instead of a connection. ## Core Features & Use Cases - Server Catalog Management: Add MCP server entries to the catalog via a single object in mcp_servers.json, or introspect any reachable server with the Custom server entry. - Personal vs Organization Connections: Configure connections sealed to a member or an organization, with specs binding services through OrgMcpServerRef or PersonalMcpServerRef. - OAuth Flow Debugging: Diagnose the five-step OAuth flow (discovery, dynamic client registration, consent, exchange, refresh) including SSRF-pinned requests and providers without registration endpoints like HubSpot. - Use Case: When a user asks to let the agent read Linear issues, use this Skill to add a Linear MCP connection instead of writing a bespoke API client capability. ## Quick Start Ask the agent to add a GitHub MCP server connection to the catalog and test that its tools are visible.

Frequently Asked Questions about mcp-connections

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an MCP server to the catalog?▼

Add a single object to app/core/catalog/mcp_servers.json with no code changes required. Alternatively, use the Custom server entry, which introspects any reachable MCP server URL without a catalog entry.

Why can't the agent see my MCP tools?▼

Each server gets a 3-second tools/list probe before the turn, and a dead server is skipped with a warning rather than raising an error. Use the /test route and last_status to check whether the connection probe succeeded.

What is the difference between personal and organization MCP connections?▼

Personal connections are sealed to a member and reached through a binding to each person's own account, while organization connections are sealed to the organization, gated by mcp:manage, and can be named directly in an agent spec.

Why does the MCP OAuth flow fail with HubSpot?▼

HubSpot has no dynamic client registration endpoint, so the flow refuses at step two. The fix is registering a client manually at the provider and passing client_id and client_secret to McpOAuthStart.

Are MCP tools gated by approval requirements?▼

No. approval_required_tools iterates spec.capabilities only, and MCP tools are discovered at run time, so nothing declares or approves them. Only model tokens count toward budget, not server-side actions.

Why do two MCP connections with the same prefix cause problems?▼

Tools are prefixed with the connection name, and two connections reducing to the same prefix are deduplicated with the first one winning. Duplicate unprefixed tool names across servers cause Pydantic AI to raise and abort the turn.