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:
| Field | Description | Example |
|---|---|---|
| Name | Display name for your agent | ”Legal Document Analyzer” |
| Description | What your agent does | ”AI-powered legal document analysis and summarization” |
| Tags | Categories for discovery | legal, ai, documents |
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.
| Type | URL Format |
|---|---|
| OpenAPI | https://api.myservice.com/openapi.json |
| MCP Manifest | https://api.myservice.com/mcp.json |
| A2A Agent Card | https://api.myservice.com/.well-known/agent.json |
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:| Column | Description |
|---|---|
| Name | Agent display name |
| ID | Unique identifier (did:nv:…) |
| Plans | Number of payment plans attached |
| Queries | Total requests received |
| Status | Active, Paused, or Pending |
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.