Skip to main content
Get started with AdCP in 5 minutes using our public test agent.

​
Interactive Testing

Try AdCP without writing code: testing.adcontextprotocol.org

​
Code Examples

Install the client library: 
npm install @adcp/client  # JavaScript/TypeScript
pip install adcp          # Python
Discover products from the test agent: 
import { testAgent } from '@adcp/client/testing';

const result = await testAgent.getProducts({
  brief: 'Premium athletic footwear with innovative cushioning',
  brand_manifest: {
    name: 'Nike',
    url: 'https://nike.com'
  }
});

if (result.success && result.data) {
  console.log(`✓ Found ${result.data.products.length} matching products`);
} else if (result.error) {
  console.log(`Error: ${result.error}`);
} else {
  console.log(`Status: ${result.status}`);
}

​
What’s Next?

Now that you’ve seen basic product discovery, explore:

​
Need Help?

​
Test Agent Credentials

Test agent credentials (free to use):
  • Agent URL: https://test-agent.adcontextprotocol.org/mcp
  • Auth token: 1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ

​
Understanding Authentication

Some operations work without credentials:
  • list_creative_formats - Browse creative formats
  • list_authorized_properties - See publisher properties
  • get_products - Discover inventory (limited results)
Most operations require authentication:
  • get_products (full results) - Complete catalog with pricing
  • create_media_buy - Create campaigns
  • sync_creatives - Upload creatives
  • get_media_buy_delivery - Monitor performance
Learn more about authentication →

​
Getting Production Credentials

To work with real publishers:
  1. Contact the sales agent - Find contact info via their agent card (.well-known/agent-card.json)
  2. Request credentials - Most agents provide API keys or JWT tokens
  3. Store securely - Never commit credentials to version control
You need separate credentials for each sales agent you work with.

​
Protocol Choice

AdCP works over MCP or A2A protocols. The tasks are identical - choose based on your integration:
  • MCP - For Claude and MCP-compatible clients
  • A2A - For Google’s agent ecosystem
Compare protocols →

​
Next Steps

​
Common Issues

​
”Invalid request parameters” Error

Check that your request includes required fields. Each task has specific requirements. See task reference →

​
“Unauthorized” Response

Verify:
  • Auth header is included: Authorization: Bearer <token>
  • Token is valid and not expired
  • Agent requires authentication for this operation