Skip to main content
The Nevermined Docs MCP Server provides seamless access to all Nevermined’s documentation directly within your AI development environment. By integrating this MCP server, you can build AI agents and applications with real-time access to Nevermined’s payment SDKs and Libraries, API references, and development guides.

​
What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and tools. Think of MCP as a “USB-C for AI” - it provides a standardized way to connect AI models to different services, documentation, and APIs. Key Benefits:
  • 🔌 Standardized Connections: Connect any MCP-compatible AI client to our documentation
  • 🔄 Real-time Access: Always up-to-date information from our docs
  • 🛡️ Secure Integration: Built-in security and authentication
  • 🌍 Remote Access: No local installation required

​
MCP Server Details

Nevermined Documentation MCP Server URL: https://docs.nevermined.app/mcp This server provides access to:
  • Complete Nevermined API documentation
  • Development guides and tutorials
  • Code examples in Python and TypeScript
  • Payment plan configuration guides
  • AI agent registration workflows

​
Setting Up Your IDE with Nevermined MCP Server

Claude Desktop provides excellent MCP support with a user-friendly interface for connecting to remote MCP servers.

​
Step 1: Install Claude Desktop

Download and install Claude Desktop from Claude’s official website.

​
Step 2: Configure the MCP Server

  1. Open Claude Desktop and sign in to your account
  2. Access Settings: Click on your profile icon and select “Settings”
  3. Navigate to Connectors: In the settings sidebar, click on “Connectors”
  4. Add Custom Connector: Scroll to the bottom and click “Add custom connector”
  5. Enter Server URL: In the dialog box, enter: 
    https://docs.nevermined.app/mcp
  6. Complete Setup: Click “Add” to establish the connection
The Nevermined Documentation MCP server will now be available in your Claude conversations!

​
Step 3: Access Nevermined Documentation

  1. Start a Conversation: Open a new chat in Claude Desktop
  2. Access Resources: Click the paperclip icon (📎) in the message input area
  3. Select Nevermined Resources: You’ll see available documentation resources from the Nevermined MCP server
  4. Use in Prompts: Select relevant documentation to include context in your conversations

​
Option 2: Using Claude Web (claude.ai)

You can also connect to the Nevermined MCP server through Claude’s web interface using Custom Connectors.

​
Step 1: Access Claude Settings

  1. Go to claude.ai and sign in
  2. Click your profile icon and select “Settings”
  3. Navigate to “Connectors” in the sidebar

​
Step 2: Add Nevermined MCP Server

  1. Click “Add custom connector”
  2. Enter the server URL: https://docs.nevermined.app/mcp
  3. Complete any authentication prompts
  4. Configure tool permissions as needed

​
Option 3: Other MCP-Compatible Clients

The Nevermined MCP server works with any MCP-compatible client. For a full list of supported clients, visit the MCP Clients page. Popular MCP-compatible tools include:
  • Continue (VS Code extension)
  • Cursor IDE
  • Zed Editor
  • Custom applications using MCP SDKs
For detailed setup instructions for other clients, refer to the Model Context Protocol documentation.

​
Prompt Examples for Building AI Agents

Once you have the Nevermined MCP server connected, you can use these example prompts to build AI agents and client applications:

​
1. Create a Basic AI Agent

I want to create an AI agent that validates user requests using Nevermined Pay.
Please show me how to:
1. Register an AI agent with Nevermined
2. Set up payment plans with credits-based pricing
3. Implement request validation in TypeScript
4. Handle authorization errors properly

Include complete code examples and explain each step.

​
2. Build a Client Application

Help me build a TypeScript client application that can:
1. Purchase access to a Nevermined AI agent
2. Send authenticated requests to the agent
3. Handle payment errors and reauthorization
4. Monitor remaining credits and subscription status

Show me the complete implementation with error handling.

​
3. Multi-Agent Workflow

I want to create a multi-agent system where:
1. Agent A processes text analysis requests
2. Agent B generates summaries based on Agent A's output
3. Both agents use different payment plans
4. Users pay once but can access both agents

How do I implement this workflow using Nevermined? Show me the agent registration, 
payment configuration, and orchestration code.

​
4. Payment Plan Configuration

Help me design payment plans for my AI service:
1. A free trial plan (100 requests, 7 days)
2. A basic plan (1000 requests per month, $10 USDC)
3. A premium plan (unlimited requests, $50 USDC per month)

Show me how to implement these plans and handle upgrades/downgrades.

​
5. Agent-to-Agent Payments

I'm building an AI agent marketplace where agents can purchase services from other agents. 
Show me how to:
1. Set up autonomous agent-to-agent payments
2. Implement automatic credit management
3. Handle payment authorization between agents
4. Track revenue and usage across multiple agents

Provide complete Python and TypeScript examples.

​
6. Integration with Existing Services

I have an existing AI service running on FastAPI. Help me integrate it with Nevermined to:
1. Add payment validation to my existing endpoints
2. Implement subscription management
3. Add usage tracking and analytics
4. Support both crypto and fiat payments

Show me how to modify my existing code with minimal changes.

​
Advanced Use Cases

​
Building Custom MCP Servers

You can also create your own MCP servers that integrate with Nevermined. Here’s how to get started: 
I want to build a custom MCP server that:
1. Exposes my company's internal AI tools
2. Uses Nevermined for access control and payments
3. Provides dynamic pricing based on tool complexity
4. Integrates with our existing authentication system

Show me the architecture and implementation using the MCP SDK.

​
Marketplace Development

Help me build an AI agent marketplace using Nevermined where:
1. Developers can register and monetize their AI agents
2. Users can discover and purchase access to agents
3. The platform takes a commission on sales
4. Agents can be combined into workflows

Include the frontend, backend, and payment integration code.

​
Enterprise Integration

I need to integrate Nevermined into our enterprise environment:
1. Connect with our existing identity provider (OAuth/SAML)
2. Implement cost allocation across departments
3. Add detailed usage reporting and analytics
4. Support both on-premise and cloud deployments

Show me the architecture and configuration needed.

​
Best Practices

When using the Nevermined MCP server, follow these best practices:

​
Security Considerations

  • Verify Connections: Always ensure you’re connecting to the official Nevermined MCP server
  • Review Permissions: Only grant necessary tool permissions in your MCP client
  • Secure API Keys: Store Nevermined API keys securely and never expose them in client-side code

​
Development Workflow

  1. Start with Documentation: Use the MCP server to understand Nevermined concepts
  2. Test in Sandbox: Always test your implementations in Nevermined’s sandbox environment
  3. Iterate with Examples: Use the provided code examples as starting points
  4. Monitor Usage: Implement proper logging and monitoring for production deployments

​
Performance Optimization

  • Cache Documentation: Cache frequently accessed documentation locally when possible
  • Batch Requests: Group related operations to minimize API calls
  • Implement Retries: Add retry logic for transient failures
  • Monitor Limits: Respect rate limits and implement backoff strategies

​
Troubleshooting

​
Common Issues

​
Connection Failed

  • Verify you’re using the correct URL: https://docs.nevermined.app/mcp
  • Check your internet connection
  • Ensure your MCP client supports remote servers

​
Authentication Errors

  • Verify your Nevermined API key is correctly configured
  • Check that you’re using the right environment (sandbox vs production)
  • Ensure your API key has the necessary permissions

​
Documentation Not Loading

  • Try refreshing the connection in your MCP client
  • Check if the MCP server is accessible at: https://docs.nevermined.app/mcp
  • Restart your MCP client if issues persist

​
Getting Help

If you encounter issues or need assistance:
  1. Check the Documentation: Use the MCP server to search for relevant guides
  2. Community Support: Join our Discord community for help
  3. GitHub Issues: Report bugs or request features on our GitHub repository
  4. Enterprise Support: Contact our team for enterprise-level assistance

​
Next Steps

Once you have the Nevermined MCP server set up:
  1. Explore the Documentation: Use the MCP connection to browse our complete documentation
  2. Build Your First Agent: Follow the quickstart guide to create your first monetized AI agent
  3. Implement Payment Plans: Design and configure payment plans that match your business model
  4. Test Integration: Use the sandbox environment to test your implementation
  5. Go Live: Deploy your AI agents to production with real payments
The Nevermined MCP server provides the foundation for building sophisticated AI applications with built-in monetization. Start exploring and building today!