Skip to content

Add Workday MCP Agent-Ready Tools reference implementation - #29

Open
srivilliamsai wants to merge 1 commit into
Workday:mainfrom
srivilliamsai:add-workday-mcp-agent-tools
Open

srivilliamsai wants to merge 1 commit into
Workday:mainfrom
srivilliamsai:add-workday-mcp-agent-tools

Conversation

@srivilliamsai

Copy link
Copy Markdown
Contributor

What this PR adds or changes

Adds examples/workday-mcp-agent-tools: an open-source reference implementation and specification of Model Context Protocol (MCP) Agent-Ready Tools for Workday.

Workday recently announced native support for the open Model Context Protocol (MCP) standard to connect autonomous AI agents and enterprise assistants with tenant data. This reference example provides the developer community with:

  1. Flattened, Agent-Ready JSON-RPC 2.0 Schemas: Unlike raw REST endpoints that return deeply nested HATEOAS structures consuming thousands of context tokens, these tools provide flattened data payloads that save up to 70% token overhead and eliminate LLM hallucinations.
  2. Core HCM & Financials Tools: Includes production-ready schemas for get_worker_profile, query_wql_readonly, get_inbox_tasks, get_time_off_balance, and get_supplier_invoice_summary.
  3. Agent System of Record (ASOR) Guardrails: Enforces read-only execution by default, security domain inheritance, SELECT-only WQL validation, and strict masking of sensitive financial and banking identifiers.
  4. Lightweight stdio Server: A zero-dependency Node.js MCP server compatible with Claude Desktop, Claude Code, Cursor, Antigravity, and LangChain/LangGraph agent runtimes, featuring an instant zero-config sandbox fallback mode for testing without live credentials.

Checklist for new or changed examples

  • The example lives entirely in its own folder under examples/
  • node scripts/validate-examples.mjs --check passes (valid example.json, README present, index table in sync)
  • The README says what the artifact is, how to use it, and what to change before deploying it (the "Before you deploy" section)
  • No credentials, tenant names, or real personal data anywhere in the folder
  • node scripts/audit-examples.mjs --dirs examples/workday-mcp-agent-tools passes with zero findings

@github-actions

Copy link
Copy Markdown

Example audit

Audited examples/workday-mcp-agent-tools. No findings. Thank you for a clean submission.

Run it yourself: ./scripts/install-arcane.sh once, then node scripts/audit-examples.mjs --changed. Rule explanations and fixes: docs/EXAMPLE_BEST_PRACTICES.md.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant