Skip to content

Conversation

@torresmateo
Copy link
Collaborator

@torresmateo torresmateo commented Dec 5, 2025

Add a new quickstart to get started with MCP Gateways with a meaningful selection of tools and connection to MCP clients.

Preview here

Note to the reviewers

  • The title is likely to change when the nav is reworked, I kept it as "Calling tools in 3rd party agents, apps, or IDEs with Arcade" so it's easy to follow and track with Linear & friends, but it's quite long in the sidebar to my taste

Note

Adds a new “MCP Gateway Quickstart” guide with step-by-step setup (including Cursor and VS Code) and links it in the docs navigation.

  • Docs:
    • New guide app/en/home/mcp-gateway-quickstart/page.mdx:
      • Walkthrough to create an MCP Gateway, select tools across MCP servers, and obtain the gateway URL.
      • Client setup for Cursor and VS Code with example JSON configs (HTTP transport, Authorization and Arcade-User-ID headers).
      • Includes images for creation, tool selection, and URL copy; guidance on tool count considerations.
    • Navigation: Adds mcp-gateway-quickstart entry to app/en/home/_meta.tsx under Getting Started.

Written by Cursor Bugbot for commit 0880992. This will update automatically on new commits. Configure here.

@vercel
Copy link

vercel bot commented Dec 5, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Dec 6, 2025 8:22pm

Copy link
Contributor

@vfanelle vfanelle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made a few comments:

  • wrote 'a MCP Server' instead of 'an MCP Server'
  • asked to adjust the photo of the tool picker to demonstrate selecting the GitHub and Linear toolkits to align with the walkthrough
  • added MCP Clients to the Next Steps
    Other than that, lgtm!


# Calling tools in 3rd party agents, apps, or IDEs with Arcade

Tools enable your AI agents to perform actions on your behalf. For specific workflows and use cases, this may involve calling tools from multiple MCP servers. Arcade facilitates this by allowing you to create MCP Gateways to federate the tools from multiple MCP servers into a single collection for easier management, control, and access. For example, if your agent specializes in solving specific tickets in Linear, you may want to use GitHub, Slack and Linear tools in your agent, but not all of them at the same time. An MCP Gateway allows you to pick only the tools required for this workflow, and you can connect it to any MCP client, making it easy to port your agent to multiple platforms and IDEs, and event share it with other users.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Tools enable your AI agents to perform actions on your behalf. For specific workflows and use cases, this may involve calling tools from multiple MCP servers. Arcade facilitates this by allowing you to create MCP Gateways to federate the tools from multiple MCP servers into a single collection for easier management, control, and access. For example, if your agent specializes in solving specific tickets in Linear, you may want to use GitHub, Slack and Linear tools in your agent, but not all of them at the same time. An MCP Gateway allows you to pick only the tools required for this workflow, and you can connect it to any MCP client, making it easy to port your agent to multiple platforms and IDEs, and event share it with other users.
Tools enable your AI agents to perform actions on your behalf. For specific workflows and use cases, this may involve calling tools from multiple MCP servers. Arcade facilitates this by allowing you to create MCP Gateways to federate the tools from multiple MCP servers into a single collection for easier management, control, and access. For example, if your agent specializes in solving specific tickets in Linear, you may want to use GitHub, Slack and Linear tools in your agent, but not all of them at the same time. A MCP Gateway allows you to pick only the tools required for this workflow, and you can connect it to any MCP client, making it easy to port your agent to multiple platforms and IDEs, and even share it with other users.

<GuideOverview>
<GuideOverview.Outcomes>

Create a coding agent using an MCP Gateway to call tools from multiple MCP servers.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Create a coding agent using an MCP Gateway to call tools from multiple MCP servers.
Create a coding agent using a MCP Gateway to call tools from multiple MCP servers.


<GuideOverview.YouWillLearn>

- Create an MCP Gateway
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Create an MCP Gateway
- Create a MCP Gateway


Click the "Select Tools" button in the form to select the tools you want to include in the gateway. You can select tools from any MCP server available to the active project. For this example, we'll select the tools from the GitHub MCP server, as well as the tools from the Linear MCP server. Feel free to select any tools you want to include in your specific use case.

<Image
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we update the image to show just GitHub and Linear selected, like this?
Screenshot 2025-12-10 at 12 46 31 PM

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd update the photo myself, but I don't know how to capture just the tool picker because it has rounded corners

height={TOOL_PICKER_DARK_HEIGHT / IMAGE_SCALE_FACTOR}
/>

Once you've selected the tools you want to include in the gateway, click the "Use N tools" button in the tool picker, and then click the "Create MCP Gateway" button to create the gateway.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once you've selected the tools you want to include in the gateway, click the "Use N tools" button in the tool picker, and then click the "Create MCP Gateway" button to create the gateway.
Once you've selected the tools you want to include in the gateway, click the "Use tools" button in the tool picker, and then click the "Create MCP Gateway" button to create the gateway.

we recommend keeping the number of tools in a single MCP Gateway below 80.
</Callout>

### Connect the MCP Gateway to an MCP client
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Connect the MCP Gateway to an MCP client
### Connect the MCP Gateway to a MCP client


Arcade MCP Gateways are compatible with any MCP client that supports:

- The Streamable HTTP transport
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The Streamable HTTP transport
- Streamable HTTP transport

### Try it out

1. Open the chat pane
1. Ask the agent to do something! For example, "Check the latest linear issue assigned to me, then create a new GitHub branch, implement the fix and add tests, if all the tests pass, create a pull request and assign it to me"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Ask the agent to do something! For example, "Check the latest linear issue assigned to me, then create a new GitHub branch, implement the fix and add tests, if all the tests pass, create a pull request and assign it to me"
1. Ask the agent to do something! For example, "Check the latest linear issue assigned to me. Then, create a new GitHub branch, implement the fix, and add tests. If all the tests pass, create a pull request and assign it to me."


## Next Steps

Learn more about [MCP Gateways](/home/mcp-gateways).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Learn more about [MCP Gateways](/home/mcp-gateways).
- Learn more about [MCP Gateways](/home/mcp-gateways).
- Learn how to use MCP Gateways with:
-- [Cursor](home/mcp-clients/cursor)
-- [Claude Desktop](/home/mcp-clients/claude-desktop)
-- [Visual Studio Code] (/home/mcp-clients/visual-studio-code)

## Next Steps

Learn more about [MCP Gateways](/home/mcp-gateways).
Build your own MCP servers with [arcade-mcp](/home/custom-mcp-server-quickstart).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Build your own MCP servers with [arcade-mcp](/home/custom-mcp-server-quickstart).
- Build your own MCP servers with [arcade-mcp](/home/custom-mcp-server-quickstart).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants