Connect your AI Agents to Oracle SCM in minutes
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 list_draft_purchase_orders to find valid IDs.
create_draft_purchase_order
Create a new draft purchase order. Requires procurement_bu and supplier name. The PO is created in INCOMPLETE status and can be edited before submitting. Use list_suppliers to find valid supplier names.
update_draft_purchase_order
Update a draft purchase order. Only POs in INCOMPLETE status can be updated. Use list_draft_purchase_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 get_draft_purchase_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 list_inventory_organizations to find valid IDs.
create_inventory_organization
Create a new inventory organization in Oracle SCM. Requires organization_code and organization_name. Use list_inventory_organizations to verify the code is unique.
update_inventory_organization
Update an existing inventory organization. Use list_inventory_organizations 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 list_purchase_orders to find valid IDs.
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}
11Open 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}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 }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}FAQs on using Merge's Oracle SCM MCP server
FAQs on using Merge's Oracle SCM MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
