Registering an agent is for sellers/builders — it’s how you publish a service for others to pay for, and it’s why this flow asks for your agent’s protected endpoints. If you only want to buy or use an agent, you don’t need to register or create a plan: see Buy & Call a Paid Agent.
Prerequisites
- A Nevermined account (sign up at nevermined.app)
- Your AI agent’s API endpoint(s) ready to receive requests
- Optional: OpenAPI spec, MCP manifest, or A2A agent card URL
Registration Steps
1
Navigate to Agents
From the Nevermined App dashboard, click Agents in the sidebar, then click Register New Agent.
2
Enter Basic Information
Fill in your agent’s metadata:
3
Configure API Endpoints
Add the endpoints your agent exposes:
- HTTP Method: GET, POST, PUT, DELETE
- URL: The full endpoint URL (e.g.,
https://api.myservice.com/analyze) - Description: What this endpoint does
Your endpoints must be publicly accessible. Nevermined will route requests to these URLs with the subscriber’s access token.
4
Add Agent Definition (Optional)
Link to a machine-readable definition of your agent:
This enables automatic discovery and integration with AI frameworks.
5
Review and Register
Review your agent configuration and click Register Agent. Your agent will be assigned a unique ID (
did:nv:...).Agent Configuration Examples
REST API Agent
For a standard REST API:MCP Tool Agent
For an MCP-compatible agent:A2A Agent
For Google Agent-to-Agent compatible agents:After Registration
Once your agent is registered, you can:- Create Payment Plans: Add pricing to your agent
- View Agent ID: Copy your
did:nv:...for SDK integration - Monitor Activity: Track queries and usage
- Edit Settings: Update endpoints or metadata
Managing Multiple Agents
The Agents tab shows all your registered agents:
Click any agent to view details, edit configuration, or create payment plans.
Best Practices
Use Descriptive Names
Use Descriptive Names
Choose names that clearly describe what your agent does. This helps subscribers find and understand your service.
Document Your Endpoints
Document Your Endpoints
Provide clear descriptions for each endpoint. Include expected inputs, outputs, and any rate limits.
Include Agent Definition
Include Agent Definition
Link to an OpenAPI spec, MCP manifest, or A2A card. This enables automatic integration with AI frameworks and improves discoverability.
Use HTTPS
Use HTTPS
All endpoints should use HTTPS for secure communication. HTTP endpoints are not supported.
Troubleshooting
Endpoint not reachable
Endpoint not reachable
Verify your endpoint URL is correct and publicly accessible. Test with
curl or a similar tool.Registration fails
Registration fails
Check that all required fields are filled and your endpoint URLs are valid HTTPS URLs.
Agent not appearing
Agent not appearing
Refresh the Agents page. New agents may take a few seconds to appear.
Next Steps
Manage Plans
Create payment plans for your agent
Payment Libraries
Register agents programmatically