User GuidesPublishing to Exchange

Publishing to Anypoint Exchange

Learn how to publish your MCP servers and Agent Cards to Anypoint Exchange for discovery and sharing.

Prerequisites

Before publishing, ensure you have:

  • ✅ MCP server or Agent Card created in MA²D
  • ✅ Compliance score ≥ 95%
  • ✅ Anypoint Platform account
  • ✅ Anypoint credentials configured in MA²D

Step 1: Configure Anypoint Credentials

First-time setup:

  1. Go to Settings > Integrations
  2. Click “Configure Anypoint Platform”
  3. Choose authentication method:
    • OAuth 2.0 (recommended)
    • Basic Auth (username/password)

OAuth 2.0 Setup

  1. Select “OAuth 2.0”
  2. Enter your Anypoint credentials
  3. Click “Authorize”
  4. Grant permissions
  5. Credentials saved securely

Basic Auth Setup

  1. Select “Basic Auth”
  2. Enter Username
  3. Enter Password
  4. Click “Save Credentials”

Step 2: Prepare for Publishing

Check Compliance

  1. Open your MCP server or Agent Card
  2. Go to “Compliance” tab
  3. Ensure score is 95% or higher
  4. Fix any violations if needed

Review Content

Verify:

  • Name - Clear, descriptive
  • Description - Complete, detailed
  • Version - Follows semantic versioning
  • Tools/Skills - All documented
  • Examples - Realistic scenarios

Step 3: Initiate Publishing

  1. Open the asset to publish
  2. Click “Publish to Exchange” button
  3. Publishing wizard opens

Step 4: Configure Exchange Metadata

Basic Information

Asset Name:

  • Auto-filled from your server/card name
  • Can edit if needed
  • Must be unique in your organization

Asset Type:

  • Automatically set (MCP Server or Agent Card)

Version:

  • Auto-filled from your version
  • Must be unique (can’t republish same version)

Classification

Categories: Select relevant categories:

  • API
  • Integration
  • AI/ML
  • Data
  • Custom categories

Tags: Add searchable tags:

weather, mcp, ai-agent, real-time

Visibility

Choose who can see your asset:

  • Public - Anyone can discover and use
  • Private - Only you can see
  • Organization - Only your org members

Documentation

Description: Automatically populated from your asset description.

Custom Pages:

  • Add getting started guide
  • Add usage examples
  • Add API documentation

Step 5: Review and Publish

  1. Review all metadata
  2. Check preview of Exchange listing
  3. Click “Publish”

Publishing takes 30-60 seconds.

Step 6: Track Publication Status

In MA²D

  1. Go to Publishing section in sidebar
  2. See publication status:
    • Publishing - In progress
    • Published - Successfully published
    • Failed - Publishing error

In Anypoint Exchange

  1. Login to Anypoint Platform
  2. Go to Exchange
  3. Search for your asset
  4. View listing

Publishing Agent Cards

Agent Cards have additional requirements:

Linked MCP Server

Agent Card must reference a published MCP server:

  1. Publish MCP server first
  2. Ensure Agent Card links to it
  3. Then publish Agent Card

Skills Validation

All skills must:

  • Have clear descriptions
  • Map to published MCP tools
  • Include examples

Updating Published Assets

Version Updates

To publish a new version:

  1. Update your asset in MA²D
  2. Increment version (e.g., 1.0.0 → 1.1.0)
  3. Click “Publish to Exchange”
  4. Select “New Version”
  5. Publish

Version history maintained in Exchange.

Metadata Updates

Update description, tags, etc without new version:

  1. Edit asset in MA²D
  2. Click “Update Exchange Listing”
  3. Select “Update Metadata Only”
  4. Publish

Managing Published Assets

View in Exchange

Direct link provided after publishing:

https://anypoint.mulesoft.com/exchange/org-id/asset-id

Analytics

In Anypoint Exchange, view:

  • Download counts
  • API calls
  • User feedback
  • Ratings

Deprecation

To deprecate an asset:

  1. In Anypoint Exchange
  2. Find your asset
  3. Click “Deprecate”
  4. Select reason
  5. Provide migration path (if applicable)

Unpublishing Assets

From MA²D

  1. Open published asset
  2. Click “Unpublish from Exchange”
  3. Confirm action
  4. Asset removed from Exchange

Warning: Users depending on your asset will lose access. Consider deprecation instead.

From Anypoint Exchange

  1. Go to asset in Exchange
  2. Click settings
  3. Select “Delete”
  4. Confirm

Publishing Best Practices

Before Publishing

  • Test Thoroughly - Verify all functionality
  • High Compliance - Aim for 100% score
  • Complete Docs - Provide detailed descriptions
  • Add Examples - Include usage examples
  • Realistic Mocks - Test data should be real-world

Versioning Strategy

Follow semantic versioning:

  • Major (X.0.0) - Breaking changes
  • Minor (x.Y.0) - New features, backward compatible
  • Patch (x.y.Z) - Bug fixes

Documentation

Include in Exchange listing:

  • Overview - What it does
  • Getting Started - Quick setup
  • API Reference - All endpoints/tools
  • Examples - Code samples
  • FAQ - Common questions

Maintenance

  • Monitor Usage - Check analytics
  • Respond to Feedback - Address issues
  • Keep Updated - Regular releases
  • Deprecate Properly - Provide migration guides

Common Issues

”Compliance score too low”

Solution: Fix violations to reach 95%+

“Asset name already exists”

Solution: Choose unique name or update existing asset

”Authentication failed”

Solution: Re-configure Anypoint credentials

”Version already published”

Solution: Increment version number

”Linked MCP server not found”

Solution: Publish referenced MCP server first (for Agent Cards)

Exchange Features

Your published assets get:

  • Discovery - Searchable in Exchange
  • Documentation - Auto-generated API docs
  • Versioning - Full version history
  • Analytics - Usage statistics
  • Ratings - User feedback
  • Support - Community forums

Organization Publishing

Roles

  • Exchange Admin - Full publish permissions
  • Exchange Contributor - Can publish to org
  • Exchange Viewer - Read-only access

Approval Workflow

Some organizations require:

  1. Submit for approval
  2. Admin reviews
  3. Admin approves or rejects
  4. If approved, publishes

Check with your org admin.

API-Based Publishing

Automate publishing via MA²D API:

curl -X POST https://ma2d.vercel.app/api/publish \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "server_id": "your-server-id",
    "visibility": "organization",
    "categories": ["API", "Integration"]
  }'

See API Reference for details.

Next Steps

After publishing:

  • Share - Send Exchange link to colleagues
  • Monitor - Track usage and feedback
  • Iterate - Improve based on feedback
  • Expand - Publish more assets

Related Guides

Congratulations on publishing! 🚀 Your asset is now discoverable in Anypoint Exchange!

Using Design RulesConsuming MCP via REST API