Connect Easyship MCP in Cursor

This guide explains how to connect Easyship MCP to your Cursor agent so you can manage shipping directly from your AI coding environment.

In this article:

• What You Need
• Step 1: Get Your Easyship API Token
• Step 2: Add the Easyship MCP Server
• Step 3: Verify the Connection
• Step 4: Try It Out
• API Token Scopes
• Easyship MCP Plugin for Cursor 
• FAQs

What You Need

• An active Easyship account
• An active Cursor account

Step 1: Get Your Easyship API Token

1. Log in to Easyship and go to Connect > New Integration.
2. Scroll down and select API Integration.
3. Under Integration Type, select I am developing a custom integration.
4. Name the key Easyship MCP for easy reference.
5. Keep the default version 2024-09 and newer and click Connect.
6. On the page that opens, click Access Token and copy the token using the copy button.

Step 2: Add the Easyship MCP Server

1. Open Cursor and go to Settings > Tools & MCP.
2. Click + Add new MCP Server.
3. Paste the following configuration:

{
  "mcpServers": {
    "easyship": {
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

4. Replace YOUR_TOKEN with the API token you copied in Step 1.

Important: Do not share your API token publicly. Never paste it into a chat window. If you accidentally share it in a prompt, revoke and rotate your token immediately in the Easyship Dashboard.

Step 3: Verify the Connection

1. In Cursor, go to Settings > Tools & MCP.
2. Under Installed MCP Servers, confirm that Easyship is listed.
3. Confirm that all tools are successfully loaded.

Step 4: Try It Out

Your Cursor agent is now connected to Easyship MCP. Try starting with a prompt like:

I want to ship a parcel from New York, USA to Toronto, Canada. Origin: 350 5th Avenue, New York, United States, 10001. Destination: 220 Yonge Street, Toronto, ON, Canada, M5B 2H1. Weight: 2 lb, dimensions: 6×2×4 cm. Item: business documents, quantity 1, HS code 4911.99, declared value $1.00 USD, DDU. Show me the cheapest and best value options with delivery times and courier names.

For a full list of available actions and example prompts, see the Easyship MCP Developer Docs.

API Token Scopes

Your Easyship API token requires the following scopes:

• public.shipment:write
• public.shipment:read
• public.label:write
• public.track:read
• public.address_validation:write
• public.address_validation_domestic:write
• public.pickup:read / public.pickup:write
• public.transaction_record:read

Easyship MCP Plugin for Cursor (Coming Soon)

Note: This feature is not yet available. The steps below are for reference only.

Once the native plugin is released, you'll be able to connect Easyship to Cursor in just a few clicks.

Install the plugin

1. In Cursor, click Settings.
2. In the left sidebar, select Marketplace.
3. Search for Easyship and click Add to Cursor.

Connect the plugin

1. Go to Settings > Tools & MCP.
2. Scroll to Plugin MCP Servers, find Easyship, and click Connect.
3. If prompted, log in to Easyship and grant the required permissions.
4. When prompted, click Open Cursor.

Verify setup

1. You'll be redirected back to Cursor Settings.
2. Under Tools & MCP, confirm that Easyship is listed as Connected and all tools are loaded.

FAQs

Can I use an existing API token, or do I need to create a new one for MCP? You can use an existing token from your account. Just make sure it has all the required scopes listed in Step 1. If some scopes are missing, certain tools will fail while others continue to work.

What if Easyship doesn't appear in my Installed MCP Servers list? Double-check the server URL and your API token. Make sure the Authorization header uses Bearer YOUR_TOKEN with a space between "Bearer" and the token, and that there are no extra spaces or line breaks in the token. If both are correct, fully quit and reopen Cursor.

What if not all tools are loaded?

• Verify your API token is valid and active
• Fully quit and reopen Cursor
• Check your network connection
• Make sure you're connecting to Easyship’s MCP  

If the issue persists, delete the server from Settings > Tools & MCP and add it again.

Why isn't my API token working after I paste it into the configuration? Check the scopes assigned to your token in the Easyship Dashboard under Connect > API. A token may work for some actions but fail for others depending on which scopes are enabled. For full access to all tools, enable all the scopes listed in Step 1. You can update scopes without creating a new token.

What happens if I don't grant all the required permission scopes? Only tools that match your granted scopes will work. Other tools will return an error, and the agent will tell you which scope is needed. You can update scopes in the Easyship Dashboard without creating a new token.

Is it safe to paste my API token directly into the agent prompt? You can do this for testing. For longer-term use, store your token in an environment variable and reference it in the config. Never commit tokens to version control or share them publicly.

Do I need to pay for API access? No, API access is included across all Easyship plans. If you exceed the included limits for your plan, overage fees may apply. See pricing plans and included API limits for details.

What's the difference between manual MCP setup and the one-click plugin? The manual setup requires you to paste the MCP server config into Cursor's settings with your API token. The one-click plugin (coming soon) will handle everything automatically — install from the Cursor Marketplace, authenticate via your Easyship account, and the MCP server connects without any manual configuration.

Can I use the same token across multiple clients (Cursor, Claude, etc.)? Yes. The same API token works across any MCP client. Be mindful of rate limits and avoid running conflicting operations, such as editing the same shipment from two clients at once.