Skip to main content

​
Prerequisites

Before connecting the Token Layer MCP server, you’ll need:
  1. A Token Layer account at tokenlayer.network
  2. Your API key (see Getting Your API Key)
  3. An MCP-compatible AI assistant (Claude Code, Claude Desktop, ChatGPT, Cursor, or Windsurf)

​
Getting Your API Key

1

Visit Token Layer Platform

Go to tokenlayer.network and sign in
2

Access Profile Menu

Hover over your profile avatar in the top-right header
3

Copy API Key

Click to copy your API key to clipboard
Copy API key from profile menu
Keep your API key secure! It provides access to your Token Layer account and can execute transactions on your behalf.

​
Claude Code

Claude Code is Anthropic’s official CLI tool. Add Token Layer with a single command:
1

Run Installation Command

Open your terminal and run:
claude mcp add --transport http token-layer https://mcp-server.onthrust.com \
  --header "Authorization: Bearer YOUR_API_KEY"
Replace YOUR_API_KEY with your actual API key from tokenlayer.network
2

Verify Installation

Start a new Claude Code session:
claude
Try: “Show me trending tokens on Token Layer”
Claude Code automatically includes the Authorization header in all MCP requests.

​
Example Usage

$ claude
You: Create a meme token called "Rocket Dog" with symbol RDOG

Claude: I'll help you create a token called "Rocket Dog" with symbol RDOG.
What blockchain would you like to deploy on?
1. Base (mainnet)
2. Base Sepolia (testnet)

You: Base Sepolia for testing

Claude: [Uses create_token MCP tool]
Token created successfully! Contract: 0x742d35Cc...

​
Claude Desktop

Claude Desktop supports MCP through a visual connector interface:
1

Open Settings

Launch Claude Desktop and click the Settings icon (gear) in the bottom-left
2

Navigate to Connectors

Select Connectors from the settings menu
3

Add Custom Connector

Click “Add Custom Connector”
4

Enter Details

  • Name: Token Layer
  • URL: https://mcp-server.onthrust.com
Click “Connect”
5

Authenticate

You’ll be redirected to authenticate with your Token Layer account
6

Authorize

Review the permissions and click “Authorize” to grant access

​
Visual Guide

Step 1: Add connector button Step 2: Enter connector details Step 3: Press connect Step 4: Authenticate Step 5: Authorize access

​
ChatGPT

ChatGPT supports custom MCP connectors through a similar interface:
1

Open Settings

In ChatGPT, click your profile icon and select Settings
2

Navigate to Connectors

Go to Settings → Connectors
3

Add Custom Connector

Click “Add Custom Connector”
4

Configure

  • Name: Token Layer
  • URL: https://mcp-server.onthrust.com
Click “Connect”
5

Complete OAuth Flow

Authenticate and authorize access (same as Claude Desktop)
The OAuth flow for ChatGPT is identical to Claude Desktop - you’ll authenticate with Token Layer and authorize the connection.

​
Cursor & Windsurf

Cursor and Windsurf are AI-powered code editors with MCP support:

​
Configuration

1

Open MCP Settings

In Cursor/Windsurf, open settings and navigate to MCP Servers or Connectors
2

Add Server Configuration

Add a new MCP server with these details:
{
  "name": "token-layer",
  "transport": "http",
  "url": "https://mcp-server.onthrust.com",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}
3

Reload Editor

Restart Cursor/Windsurf to apply the configuration
4

Test Connection

Ask the AI: “What are the trending tokens on Token Layer?”

​
Alternative: Config File

You can also add the MCP server via config file: 
{
  "mcpServers": {
    "token-layer": {
      "transport": "http",
      "url": "https://mcp-server.onthrust.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Replace YOUR_API_KEY with your actual API key. Never commit API keys to version control!

​
Testing Your Connection

Once connected, try these commands to verify everything works: 
"Show me the top 5 trending tokens on Token Layer"

​
Troubleshooting

  • Verify your API key is correct
  • Check that you copied the full key without extra spaces
  • Try generating a new API key from tokenlayer.network
  • Verify the MCP server is properly configured
  • Restart your AI assistant
  • Check the Tools Reference for available tool names
  • Ensure you have sufficient balance for gas fees
  • Check that you’re using the correct network (mainnet vs testnet)
  • Review transaction details before confirming

​
Security Best Practices

Protect Your API Key

Never share your API key or commit it to public repositories

Review Permissions

Understand what actions the MCP server can perform on your behalf

Monitor Activity

Regularly check your transaction history on tokenlayer.network

Revoke Access

You can revoke API keys anytime from your account settings

​
Next Steps

Explore MCP Tools

Learn about all available tools and their capabilities

Example Prompts

Get inspired with ready-to-use prompt examples

API Reference

Dive deeper into the underlying API

Get Support

Contact us for help