Skip to main content
Register your AI agents through the Nevermined App’s visual interface. This guide walks through each step of the registration process.

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:
FieldDescriptionExample
NameDisplay name for your agent”Legal Document Analyzer”
DescriptionWhat your agent does”AI-powered legal document analysis and summarization”
TagsCategories for discoverylegal, 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
You can add multiple endpoints for a single agent.
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:
TypeURL Format
OpenAPIhttps://api.myservice.com/openapi.json
MCP Manifesthttps://api.myservice.com/mcp.json
A2A Agent Cardhttps://api.myservice.com/.well-known/agent.json
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:
Name: Data Analysis API
Description: Statistical analysis and visualization service

Endpoints:
- POST https://api.dataservice.com/analyze
- GET https://api.dataservice.com/status/{job_id}
- GET https://api.dataservice.com/results/{job_id}

Definition URL: https://api.dataservice.com/openapi.json

MCP Tool Agent

For an MCP-compatible agent:
Name: Code Review Assistant
Description: AI-powered code review and suggestions

Endpoints:
- POST https://mcp.codereviewer.com/review

Definition URL: https://mcp.codereviewer.com/mcp.json

A2A Agent

For Google Agent-to-Agent compatible agents:
Name: Travel Booking Agent
Description: Autonomous travel planning and booking

Endpoints:
- POST https://a2a.travelbot.com/tasks

Definition URL: https://a2a.travelbot.com/.well-known/agent.json

After Registration

Once your agent is registered, you can:
  1. Create Payment Plans: Add pricing to your agent
  2. View Agent ID: Copy your did:nv:... for SDK integration
  3. Monitor Activity: Track queries and usage
  4. Edit Settings: Update endpoints or metadata

Managing Multiple Agents

The Agents tab shows all your registered agents:
ColumnDescription
NameAgent display name
IDUnique identifier (did:nv:…)
PlansNumber of payment plans attached
QueriesTotal requests received
StatusActive, Paused, or Pending
Click any agent to view details, edit configuration, or create payment plans.

Best Practices

Choose names that clearly describe what your agent does. This helps subscribers find and understand your service.
Provide clear descriptions for each endpoint. Include expected inputs, outputs, and any rate limits.
Link to an OpenAPI spec, MCP manifest, or A2A card. This enables automatic integration with AI frameworks and improves discoverability.
All endpoints should use HTTPS for secure communication. HTTP endpoints are not supported.

Troubleshooting

Verify your endpoint URL is correct and publicly accessible. Test with curl or a similar tool.
Check that all required fields are filled and your endpoint URLs are valid HTTPS URLs.
Refresh the Agents page. New agents may take a few seconds to appear.

Next Steps