---
schema_version: "1"
id: 9898eddc5c93ffd8694d9d2b4f295d0c5eaf5b5ae94c5f3001dbb5dfe99c87d2
title: Register Services Manually
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/general/exp-services-register-manually.md
canonical_url: https://docs.mulesoft.com/general/exp-services-register-manually
source_site: docs.mulesoft.com
content_type: documentation
content_hash: f9ecaa30700e18ba4677615ae8eb50e7cc148512bc4db2ce400c17733440ebf0
description: MuleSoft Documentation Site
latest: true
---
---
product: Getting Started
keywords: register services manually, mcp servers, agents, service registration, mulesoft, anypoint platform, manual configuration
---

# Register Services Manually

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Register a service to add it to your portfolio when you already have the metadata, specification,
endpoint, or card required in Enhanced Experience, without running a provider scan. Start from
**Home** or from the catalog for that service type in **Portfolio**. Completed registrations appear
in the matching catalog.

To learn how manual registration relates to provider connections, see
[Adding Services to Your Portfolio](https://docs.mulesoft.com/general/exp-services-add-to-portfolio).

## Before You Begin

Before getting started, make sure you have:

- An Anypoint Platform account.

- One of these permissions:

  - Exchange: Exchange Contributor

  - Exchange: Exchange Administrator

  - Exchange: Exchange Creator

  For more information, see [Enhanced Experience Permissions](https://docs.mulesoft.com/general/exp-home-start#permissions).

## Get Started

- **Home**

  Open **Add Services**, select the service type, then, if it is available, select manual
  registration .

- **Portfolio**

  Open the **Agents**, **MCP Servers**, **Model Proxies**, or **APIs** catalog, use the add control
  for that type (for example **Add API**), and select **Register Manually**.

To set up a gateway, select **Add Gateway** to open gateway setup in Anypoint Platform. Navigation
labels can vary by catalog, enabled features, and release.

## Agents

Register an agent by uploading an agent card file for an A2A or non-A2A agent.

Manual registration does not support A2A or non-A2A connection routes, and the system does not
validate a connection before creating the agent.

## MCP Servers

For MCP servers, define how the system reaches the server and validates runtime access:

- **By MCP URL** — Connect over a URL and test the live server so tools and metadata can be
  discovered.

- **Upload Schema** — Upload a schema and supply the details needed to register and test the server.

Successful registration stores the MCP server in the **MCP Servers** catalog.

## Model Proxies

Model proxy registration has two parts: associate the proxy with a gateway and deployment context,
then define routing (and any provider connections your flow requires). After setup is complete, the
Model proxy appears in the **Model Proxies** catalog.

## APIs

Add an API to the **APIs** catalog by registering it manually or by connecting to a provider.

- **Register manually**–Upload a specification file to define a new API.

- **Connect to provider**–Discover and import APIs from external platforms. See
  [Create a Scanner for Provider Services](https://docs.mulesoft.com/general/exp-services-connect-providers-to-add).

### Register an API Manually

When you register an API manually, you provide a specification file that defines the API structure,
including endpoints, operations, and data types.

1.  In the navigation pane, select **APIs**.

2.  Click **Add API**.

3.  Select **Register manually**.

4.  Enter a name for the API.

5.  Select the API type.

6.  Upload the specification file.

7.  Click **Create**.

The experience supports multiple API types and specification formats:

- REST APIs (OAS, RAML)

- gRPC APIs (Proto files)

- Async APIs (AsyncAPI specification)

## Gateways

Manual gateway registration isn’t supported in the enhanced experience.

To set up a gateway, select **Add Gateway** to open gateway setup in Anypoint Platform.

## See Also

- [Adding Services to Your Portfolio](https://docs.mulesoft.com/general/exp-services-add-to-portfolio)

- [Create a Scanner for Provider Services](https://docs.mulesoft.com/general/exp-services-connect-providers-to-add)

- [Viewing Service Details in the Portfolio](https://docs.mulesoft.com/general/exp-services-view-details)