27 AI Registry
AI Registry is the central catalog of agents and MCP servers for Oracle AI Data Platform. It supports open standards including MCP and A2A.
AI Data Platform is where agents are built and deployed. Oracle Agent Hub is where business users talk to them. The AI Registry is the layer in between them. AI Registry makes an agent or a tool discoverable and usable outside the environment it was built in. Agents and tools must be registered in AI Registry before they can be shared in the Agent Hub. See How Enterprise AI Works in Agent Hub in Using Oracle Agent Hub.
You can register the following agents and tools in the AI Data Platform AI Registry:
| Type | Description |
|---|---|
| AI Data Platform agent | An agent built and deployed in AI Data Platform, in a workspace you have access to. Also called a local agent in AI Data Platform AI Registry. |
| External agent | An agent hosted outside AI Data Platform, added by its A2A agent card URL. |
| MCP server | A Model Context Protocol (MCP) server that exposes a set of tools agents can call. |
In AI Registry, you can manage AI agents, MCP servers, and credentials needed to use both. On the AI Registry page, you can use Agents, MCP servers, and Credentials tabs to view a lists of each. You can use the search bar to filter visible options by name or description. On the Agents tab, you can use the Sort by drop-down menu to sort by how recently agents have been added to the registry.
Clicking an agent card displays the details for that agent, providing the creator, source, version, a URL for the agent card, and protocol version. You can switch between the details view and a JSON view of the card using the options in the top-right corner of the card.
Before registering new external agents or MCP servers, you need to first register their authentication credentials in the Credentials tab. You can then register new agents and MCP servers by clicking Register in the top-right and selecting the appropriate option. Permissions for AI Registry are managed from the Permissions tab.
About Agent Cards
Agent Cards are the metadata structure that describes an agent. AI Registry reads them during registration and shows them to you for review before you commit.
For more information, see the A2A Protocol Specification.
- Name, version, and description.
- The agent card URL, which is where the card itself is published.
- Protocol version.
- Input and output modes. For example, text, text/plain, or text/html.
- Capabilities, such as Streaming.
- Skills, each with its own name and description.
Create Credentials in AI Registry
You can save credentials needed for use in authenticating AI Registry objects like agents and MCP servers.
- On the Home page, click
AI Registry. - Click the Credentials tab, then click Create credential.
- Enter a name and description for the credential.
- Select the Credential type from the drop-down menu.
- Select the Grant type from the drop-down menu.
- Enter the Authorization URL, Access token URL, Client ID, Client secret, and Refresh URL for your credentials.
- Enter a Scope name and value. At least one Scope name and value is required. Add additional Scope names and values by clicking Add scope.
- Copy the Redirect URL. You need to paste the Redirect URL to the confidential application in your identity domain. The following example demonstrates how to copy the Redirect URL to Oracle Cloud Infrastructure:
- Log in to the OCI console.
- Click Identity & Security, then Domains, then Integrated applications.
- Select the application you want to update redirect URLs for.
- Click the OAuth Configuration tab, then click Edit OAuth configuration.
- Apply any redirect URLs needed, then click Submit.
- Click Create.
Register a Local Agent in AI Registry
You can register local AI agents from Oracle AI Data Platform workspaces you have access to.
- On the Home page, click
AI Registry. - Click Register, then click Agent.
- Click Local agent.
- From the Workspace drop-down menu, select the workspace the local agent is located in.
- From the Agent drop-down menu, select the agent you want to register.
- Optional: Hover over the card icon for a preview of the agent card.
- Click Next.
- Confirm the agent details are correct, then click Register.
Register an External Agent in AI Registry
You can register external AI agents from supported sources to your AI Registry. These agents must conform to the A2A protocol.
- On the Home page, click
AI Registry. - Click Register, then click Agent.
- Click External agent.
- Enter the agent card URL.
- Optional: If your endpoint requires secure credentials, select Require authentication, then select the credentials from the Credentials drop-down menu.
- Click Next.
- Optional: If you selected Require authentication, enter the credentials for an account that is entitled to the agent in the dialog that appears.
- Review the agent details for accuracy, then click Register.
Register an MCP Server in AI Registry
An MCP server exposes a set of tools that agents can discover and call through a standard interface. Registering one in AI Registry makes those tools available in the platform.
Note:
If your MCP server requires authentication, you must first create the OAuth credentials in AI Registry. Credentials cannot be added as part of registering an MCP server.- On the Home page, click
AI Registry. - Click Register, then click MCP Server.
- Enter the URL of the MCP server endpoint.
- Enter a helpful Display name and Description. Users and agents will use these to identify the purpose of the MCP server.
- From the drop-down menu, select the Transport method.
- Optional: If your MCP server requires secure credentials, select Require authentication. Select the credentials from the Credentials drop-down menu.
- Click Continue.
- Review the list of included tools for the selected MCP server. Select the tools you want to include individually or click Select all to include all listed tools.
- Click Register.