Skip to main content
All you need to get started is an agent server. For this quickstart, we will be using an A2A agent.
1

Fetch your server URL

Make use of one of the following agent servers and configure it as the upstream agent server. This is used to fetch the agent card and authenticate requests.

Hello world A2A Agent

https://hello.a2aregistry.org

Simple A2A Agent with tools and header based authentication

https://a2a-header-auth.ayush-0a3.workers.devheaders: Authorization: Bearer secret-key-1

Host your own Agent!

You can host your own A2A Agent server following the instructions in the Agent Server SDK documentation.
2

Add agent to registry

1

configure the agent

Access the Agent Registry and configure the agent server URL.
2

Fetch agent card and validate

validate transport and authentication schemes by clicking the Fetch Agent Card button.
3

Provision workspaces

3

Verify your integration!

1

Grab your portkey API key

Head over to the API Keys page and create a new API key. Make sure the agents.invoke scope is enabled for your API key
2

Fetch the agent server URL from the agents tab

open the Agents tab and fetch the corresponding agent server URL. This is the URL you will use to connect your agent to the Portkey Agent Gateway instead of the agent server URL. It looks something like this (you can replace the agent slug with your server’s slug): https://agents.portkey.ai/v1/agent/header-based-authentication

​
Interface with your agent!!!

You can simply replace your agent server URL with the one you fetched from the agents tab and test out the integration. Alternatively, make use of one of the code snippets below! 
curl --location --request POST 'https://agents.portkey.ai/v1/agent/{agent-slug}/.well-known/agent.json' \
--header 'Content-Type: application/json' \
--header 'x-portkey-api-key: {PORTKEY_API_KEY}'

​
Further Reading

Last modified on April 20, 2026