{"id":30257621,"url":"https://github.com/PipedreamHQ/mcp","last_synced_at":"2025-08-15T16:05:20.539Z","repository":{"id":302524738,"uuid":"1002926247","full_name":"PipedreamHQ/mcp","owner":"PipedreamHQ","description":"Examples of using Pipedream's MCP server in your app or AI agent.","archived":false,"fork":false,"pushed_at":"2025-08-09T22:19:42.000Z","size":2350,"stargazers_count":120,"open_issues_count":3,"forks_count":20,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-09T23:29:21.381Z","etag":null,"topics":["ai","development","mcp","tools"],"latest_commit_sha":null,"homepage":"https://pipedream.com/docs/connect/mcp/developers","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PipedreamHQ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-06-16T11:03:04.000Z","updated_at":"2025-08-09T22:19:45.000Z","dependencies_parsed_at":"2025-07-25T19:16:42.680Z","dependency_job_id":"5673d39f-1f1a-4d16-84d1-c013c35aa3ce","html_url":"https://github.com/PipedreamHQ/mcp","commit_stats":null,"previous_names":["pipedreamhq/mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PipedreamHQ/mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PipedreamHQ%2Fmcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PipedreamHQ%2Fmcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PipedreamHQ%2Fmcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PipedreamHQ%2Fmcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PipedreamHQ","download_url":"https://codeload.github.com/PipedreamHQ/mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PipedreamHQ%2Fmcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270594163,"owners_count":24612661,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-15T02:00:12.559Z","response_time":110,"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":["ai","development","mcp","tools"],"created_at":"2025-08-15T16:02:34.452Z","updated_at":"2025-08-15T16:05:20.525Z","avatar_url":"https://github.com/PipedreamHQ.png","language":null,"funding_links":[],"categories":["Others","🚀 Community Apps \u0026 Experiments"],"sub_categories":[],"readme":"# Pipedream MCP Examples\n\nThis repo contains examples to highlight how you can build an AI chat app using Pipedream's MCP server.\n\n\u003e Check out the chat app in production at: [chat.pipedream.com](https://chat.pipedream.com)\n\n## What makes Pipedream's MCP server unique\n\nMost traditional MCP implementations provide only a fixed set of tools. Pipedream's MCP server offers the ability to identify and load tools dynamically, which means tools can either be pre-defined or discovered and configured on-demand, based on the user's query.\n\nThis type of [tool discovery](https://modelcontextprotocol.io/docs/concepts/tools#tool-discovery-and-updates) is defined in the MCP spec, but most MCP clients don't support yet provide support for it.\n\nThis repo contains examples of how you, as the developer of an MCP client, can use Pipedream's app-level **or dynamic** MCP server by manually reloading the list of tools on each turn.\n\n## Examples\n\nThis repo includes three examples showing different approaches to integrating with Pipedream's dynamic MCP server:\n\n- The **[Chat App Example](examples/chat/)** is a full-featured web application demonstrating MCP integration in a real-world chat interface\n- The **[AI SDK Example](examples/ai-sdk/)** uses Vercel's AI SDK with automatic tool handling\n- The **[OpenAI SDK Example](examples/openai-sdk/)** uses OpenAI SDK directly with manual tool conversion for full control\n\n### Installation\n\nInstall dependencies:\n\n```bash\npnpm install\n```\n\n### Prerequisites\n\nTo set up your environment, you'll need:\n\n1. A [Pipedream account](https://pipedream.com/auth/signup)\n2. A [Pipedream project](https://pipedream.com/docs/projects/#creating-projects). Accounts connected via MCP will be stored here.\n3. [Pipedream OAuth credentials](https://pipedream.com/docs/rest-api/auth/#oauth)\n4. An [OpenAI API key](https://platform.openai.com/api-keys)\n\n### Set up your environment\n\nCopy the example environment file and add your credentials:\n\n```bash\ncp .env.example .env\n```\n\nLearn more about [environments in Pipedream Connect](https://pipedream.com/docs/connect/managed-auth/environments).\n\n### Running the examples\n\nYou can run the examples using the following commands from the root directory:\n\n#### Chat App Example\n\nThe chat app is a full-featured Next.js web application that demonstrates MCP integration in a production-ready environment:\n\n```bash\npnpm chat\n```\n\nThe chat app includes:\n\n- **MCP integrations**: Connect to thousands of APIs through Pipedream's MCP server with built-in auth\n- **Flexible LLM and framework support**: Works with any LLM provider or framework\n- **Tool discovery**: Execute tool calls across different APIs via chat\n\nFor development, you can disable user sign-in and chat storage by setting these env vars:\n\n```bash\n# In .env\nDISABLE_AUTH=true\nDISABLE_PERSISTENCE=true\nEXTERNAL_USER_ID=your-dev-user-id\n```\n\n#### Vercel AI SDK Example\n\n```bash\npnpm ai-sdk -u \u003cexternal-user-id\u003e \"\u003cprompt\u003e\"\n```\n\n#### OpenAI SDK Example\n\n```bash\npnpm openai-sdk -u \u003cexternal-user-id\u003e \"\u003cprompt\u003e\"\n```\n\nFor example:\n\n```bash\npnpm ai-sdk -u \u003cuuid\u003e \"Send a funny joke to the #random channel in Slack\"\npnpm openai-sdk -u \u003cuuid\u003e \"Send a funny joke to the #random channel in Slack\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPipedreamHQ%2Fmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPipedreamHQ%2Fmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPipedreamHQ%2Fmcp/lists"}