Merge Unified's Oracle SCM integration Merge Agent Handler's Oracle SCM MCP server

Connect your AI Agents to Oracle SCM in minutes

Merge lets you securely connect your agents to Oracle SCM and thousands of tools instantly

Start building for free

Read docs

Oracle SCM

Learn more about Merge Agent Handler

Available tools

list_draft_purchase_orders

List draft purchase orders from Oracle SCM. Returns paginated list of POs in draft/incomplete status. Use limit/offset for pagination and q for filters (e.g. q=StatusCode='INCOMPLETE').

get_draft_purchase_order

Get a single draft purchase order by POHeaderId. Returns full details including supplier, lines, and amounts. Use listdraftpurchase_orders to find valid IDs.

create_draft_purchase_order

Create a new draft purchase order. Requires procurementbu and supplier name. The PO is created in INCOMPLETE status and can be edited before submitting. Use listsuppliers to find valid supplier names.

update_draft_purchase_order

Update a draft purchase order. Only POs in INCOMPLETE status can be updated. Use listdraftpurchase_orders to find valid IDs.

delete_draft_purchase_order

Delete a draft purchase order permanently. Only POs in INCOMPLETE status can be deleted. This action cannot be undone.

submit_draft_purchase_order

Submit a draft purchase order for approval. The PO must be in INCOMPLETE status with all required fields populated. Use getdraftpurchase_order to verify completeness first.

list_inventory_organizations

List inventory organizations from Oracle SCM. Returns paginated list with organization code, name, status, and location. Use limit/offset for pagination and q for filters (e.g. q=Status='Active').

get_inventory_organization

Get a single inventory organization by OrganizationId. Returns full details including code, name, status, location, and master org info. Use listinventoryorganizations to find valid IDs.

create_inventory_organization

Create a new inventory organization in Oracle SCM. Requires organizationcode and organizationname. Use listinventoryorganizations to verify the code is unique.

update_inventory_organization

Update an existing inventory organization. Use listinventoryorganizations to find valid IDs.

list_purchase_orders

List purchase orders from Oracle SCM. Returns paginated list with order number, status, supplier, amounts, and dates. Use limit/offset for pagination and q for filters (e.g. q=StatusCode='OPEN').

get_purchase_order

Get a single purchase order by POHeaderId. Returns full PO details including lines summary, supplier, amounts, and status. Use listpurchaseorders to find valid IDs.

get_purchase_order_lines

Get line items for a purchase order. Returns item details, quantities, prices, and status for each line. Use listpurchaseorders to find valid PO IDs.

close_purchase_order

Close a purchase order. Only OPEN purchase orders can be closed. Use listpurchaseorders to find open POs.

cancel_purchase_order

Cancel a purchase order. This action cannot be undone. Use listpurchaseorders to verify the PO status before cancelling.

list_sales_orders

List sales orders from Oracle SCM Order Hub. Returns paginated list with order number, status, customer, and amounts. Use limit/offset for pagination and q for filters (e.g. q=StatusCode='OPEN').

get_sales_order

Get a single sales order by OrderKey (HeaderId or SourceSystem:TransactionId). Returns full order details including lines, customer, and pricing. Use listsalesorders to find valid keys.

create_sales_order

Create a new sales order in Oracle SCM Order Hub. Requires sourcetransactionsystem and sourcetransactionid. Optionally specify buyingpartyname, businessunitname, and currency.

update_sales_order

Update a sales order. Use listsalesorders to find the OrderKey. Only editable orders can be updated (check IsHeaderUpdatableByCurrentUserFlag).

delete_sales_order

Delete a sales order permanently. This action cannot be undone. Use listsalesorders to verify the order before deleting.

list_suppliers

List suppliers from Oracle SCM. Returns paginated list with supplier name, number, status, and type. Use limit/offset for pagination and q for filters (e.g. q=Status='ACTIVE').

get_supplier

Get a single supplier by SupplierId. Returns full details including name, number, status, DUNS number, and contact info. Use list_suppliers to find valid IDs.

list_transfer_orders

List transfer orders from Oracle SCM. Returns paginated list with header number, status, business unit, and total price. Use limit/offset for pagination and q for filters (e.g. q=Status='Open').

get_transfer_order

Get a single transfer order by HeaderId. Returns full details including lines, status, and business unit. Use listtransferorders to find valid IDs.

update_transfer_order

Update a transfer order header fields (e.g. MessageText). Most transfer order mutations happen at the line level. Use additionalfields for other header attributes. Only open transfer orders can be updated. Use listtransfer_orders to find valid IDs.

validate_credential

Validate Oracle SCM credentials by making a lightweight API call. Used during credential setup to verify authentication is working correctly.

list_work_orders

List manufacturing work orders from Oracle SCM. Returns paginated list with work order number, status, item, and quantities. Use limit/offset for pagination and q for filters.

get_work_order

Get a single work order by WorkOrderId. Returns full details including operations, materials, and status. Use listworkorders to find valid IDs.

create_work_order

Create a new manufacturing work order. Requires organizationcode, workordertype, and itemnumber. Use listinventoryorganizations to find valid org codes.

update_work_order

Update a manufacturing work order. Use listworkorders to find valid IDs.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Oracle SCM MCP server

What is an Oracle SCM MCP?

An Oracle SCM MCP is an MCP server that connects your agents to Oracle Supply Chain Management Cloud via tools. Your agents can invoke these tools to create and track purchase orders, query inventory levels, manage supplier records, log receipts, and more.

Oracle doesn't offer an MCP server purpose built for Oracle SCM Cloud, but you can use one from a third-party platform, like Merge Agent Handler.

How can I use the Oracle SCM MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

Reorder automation: When inventory for a critical item drops below a safety stock threshold in a warehouse management system, an agent creates a purchase order in Oracle SCM for the appropriate supplier and quantity without manual intervention

Supplier delivery monitoring: An agent queries open purchase orders and their expected receipt dates, identifies lines that are past due, and posts a summary to a procurement team channel so buyers can follow up before stockouts occur

Receipt and invoice matching: When a new supplier invoice arrives in an AP system, an agent retrieves the corresponding purchase order from Oracle SCM, compares quantities and unit prices, and flags discrepancies for human review before approval

Inventory level reporting: An agent pulls on-hand quantities by item and location from Oracle SCM on a scheduled cadence and generates a stock status report for operations or finance teams

What are popular tools for Oracle SCM's MCP server?

Here are some of the most commonly used tools:

list_purchase_orders: retrieves purchase orders filtered by supplier, status, or date range. Use this when an agent needs to audit open orders, identify past-due lines, or match orders against incoming invoices

create_purchase_order: creates a new purchase order in Oracle SCM for a specified supplier, item, quantity, and delivery date. Call this when an agent detects a replenishment trigger and needs to place an order automatically

get_on_hand_quantity: returns current inventory levels for an item across one or more locations. Good for agents that monitor stock positions and need to evaluate whether replenishment or reallocation is required

list_suppliers: retrieves supplier records with contact, site, and status data. Helpful when an agent needs to identify the right supplier before creating a purchase order or validating an invoice

create_receipt: records the receipt of goods against a purchase order line in Oracle SCM. Call this when an agent processes a physical delivery confirmation and needs to update the system of record to close the loop on an open PO

list_work_orders: returns manufacturing work orders with item, quantity, status, and scheduled completion data. Useful for agents that track production progress and need to coordinate materials or flag delays to planners.

What makes Merge Agent Handler's Oracle SCM MCP server better than alternative Oracle SCM MCP servers?

Here is what makes Merge Agent Handler's Oracle SCM MCP server the stronger choice over building a custom integration or using an alternative:

Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Oracle SCM, this means you can prevent supplier pricing, contract terms, and inventory valuation data from being exposed even when the agent has broad read access

Managed authentication and credentials: Merge stores and refreshes Oracle SCM credentials on your behalf. You never expose raw API keys or OAuth tokens to an agent or manage credential rotation across environments manually

Real-time observability and audit trail: Every tool call made against Oracle SCM is logged with timestamp, tool name, input parameters, and response metadata. Procurement and operations teams can audit exactly what an agent created, queried, or modified without any additional instrumentation

Tool Packs and controlled access: Tool Packs let you bundle specific Oracle SCM tools with tools from other connectors into a single MCP endpoint, scoped to a specific use case. An agent handling inventory reporting doesn't need access to purchase order creation or supplier management tools

How can I start using Merge Agent Handler's Oracle SCM MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).

2. Create a new Tool Pack, then find and enable the Oracle SCM connector. Choose which tools to include: enable read tools for inventory and order monitoring use cases, or add write tools if your agent needs to create purchase orders, log receipts, or update records.

3. Add a Registered User inside the Tool Pack. This is the identity context under which your agent operates. Merge generates a unique MCP URL scoped to this user once it's created.

4. From the Registered User detail page, authenticate Oracle SCM by completing the credential flow. Merge stores and manages the credentials going forward.

5. Copy the MCP URL from the Tool Pack detail page and generate an API key from Settings. You'll need both to connect your agent.

6. Add the MCP server to your agent or IDE using the MCP URL and API key. Your Oracle SCM tools are now accessible through that endpoint.