Amazon Bedrock AgentCore

• From AWS Marketplace: launch the product from your subscription, create an OAuth client from the access keys Parallel provides, and add Parallel to a Gateway, all in the AWS console. Start here if you’re new to AgentCore.
• With the AWS CLI: create the Gateway, credential provider, and target yourself with a Parallel API key. Use this for infrastructure as code, or when you want to control every setting.

• A Gateway that only callers you authorize can invoke.
• Your Parallel credentials stored in AgentCore Identity, never hard-coded into an agent or request body. Option A stores an OAuth client; Option B stores an API key.
• A Gateway target pointed at https://mcp-aws.parallel.ai/mcp, with the Gateway adding an Authorization: Bearer header on every outbound call.

​

Prerequisites

• A subscription to the Parallel Search API listing. Option A walks you through subscribing.
• An AWS Region where both the AgentCore control plane and the Gateway data plane are available. Check the Region tables first; the two lists differ.
• Permission to create AgentCore Gateways and targets, and IAM roles and policies.

​

Option A: Connect from AWS Marketplace

1

Launch the product

Subscribe to the Parallel Search API listing if you haven’t already. Then, in the AWS Marketplace console, open Manage subscriptions, choose Parallel Search API, and choose Launch product.

2

Choose Amazon Bedrock AgentCore

Under Launch method, select Amazon Bedrock AgentCore instead of API. The page then lists the four steps that connect Parallel to AgentCore.

3

Register with Parallel and get your access keys

In step 2 on the page, choose Sign in or register with vendor if you haven’t registered yet. Parallel’s platform opens in a new tab, where you sign in or create a new organization linked to your AWS account.When you return, AWS Marketplace saves your access keys in AWS Secrets Manager. Choose Show access keys to see the Client Id, Client Secret, and Discovery URL. You need all three in the next step.

4

Create an Outbound Auth

In step 3 on the page, choose Create Outbound Auth. If you already created an Outbound Auth for Parallel, you can skip this step and reuse it.

The AgentCore console opens the Add OAuth Client page. Fill in:

• Name: any name, such as parallel-oauth-client.
• Provider: Custom provider.
• Configuration type: Discovery URL.
• Discovery URL, Client ID, and Client secret: the access keys from the previous step.

Leave the other fields at their defaults and choose Add OAuth Client.

5

Add Parallel to a Gateway

In step 4 on the page, under Gateway type, choose Add product to new gateway or Add product to existing gateway. Then choose Set up on AgentCore.

For a new gateway, AgentCore opens the Create gateway form. Enter a Gateway name, then choose an Inbound Auth type, which controls who can call the Gateway. Choose Use IAM permissions if you’ll call the Gateway from the Bedrock Responses API. Under Permissions, keep Create default role.

In the target section, set:

• Target name: a short, stable name such as parallel-search. It becomes part of every tool name your agents see. See Verify.
• Target type: MCP server.
• MCP endpoint: https://mcp-aws.parallel.ai/mcp.
• MCP listing mode: Default.
• Outbound Auth configurations: OAuth client, then choose the OAuth client you created in the previous step.

Choose Create Gateway. To add Parallel to an existing gateway instead, add a target with the same settings.

​

Option B: Connect with the AWS CLI

• An AgentCore Gateway. To create one, see Set up an AgentCore gateway. Use IAM inbound authorization if you’ll call it from the Bedrock Responses API.
• An API key from the Parallel organization linked to your Parallel Search API subscription.

​

Step 1: Store your Parallel API key in AgentCore Identity

{
  "name": "<PARALLEL_CREDENTIAL_PROVIDER_NAME>",
  "apiKey": "<PARALLEL_API_KEY>"
}

aws bedrock-agentcore-control create-api-key-credential-provider \
  --cli-input-json file://create-credential-provider.json

​

Step 2: Add the Parallel MCP target

{
  "name": "parallel-search",
  "description": "Parallel Search on AWS",
  "targetConfiguration": {
    "mcp": {
      "mcpServer": {
        "endpoint": "https://mcp-aws.parallel.ai/mcp",
        "listingMode": "DEFAULT"
      }
    }
  },
  "credentialProviderConfigurations": [
    {
      "credentialProviderType": "API_KEY",
      "credentialProvider": {
        "apiKeyCredentialProvider": {
          "providerArn": "<PARALLEL_API_KEY_CREDENTIAL_PROVIDER_ARN>",
          "credentialLocation": "HEADER",
          "credentialParameterName": "Authorization",
          "credentialPrefix": "Bearer "
        }
      }
    }
  ]
}

aws bedrock-agentcore-control create-gateway-target \
  --gateway-identifier <GATEWAY_ID> \
  --cli-input-json file://create-search-target.json

​

Verify

​

Calling the Gateway

​

From Amazon Bedrock

curl https://bedrock-mantle.<REGION>.api.aws/v1/responses \
  -H "Authorization: Bearer $BEDROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "tools": [
      {
        "type": "mcp",
        "server_label": "parallel_search",
        "connector_id": "<GATEWAY_ARN>",
        "require_approval": "never"
      }
    ],
    "input": "Find the most recent official sources about <TOPIC>."
  }'

• The Gateway uses IAM inbound authorization.
• The role making the request has bedrock-agentcore:InvokeGateway on the Gateway ARN.
• <MODEL_ID> is a model that supports the Responses API in your Region. See API compatibility by model.

​

From Strands Agents

pip install strands-agents mcp-proxy-for-aws

from mcp_proxy_for_aws.client import aws_iam_streamablehttp_client
from strands import Agent
from strands.tools.mcp import MCPClient

GATEWAY_URL = "<GATEWAY_URL>"  # from the Gateway's details in the AgentCore console

gateway = MCPClient(lambda: aws_iam_streamablehttp_client(
    endpoint=GATEWAY_URL,
    aws_region="<REGION>",
    aws_service="bedrock-agentcore",
))

with gateway:
    tools = gateway.list_tools_sync()
    print([tool.tool_name for tool in tools])

    agent = Agent(tools=tools)
    agent("What changed in the EU AI Act this month? Cite your sources.")

​

Pricing

​

Support