Skip to content

Add AGENTS.md — MCP Agent Instructions#672

Open
javierfajardo85-rgb wants to merge 1 commit into
pinecone-io:mainfrom
javierfajardo85-rgb:mai1-agents-md
Open

Add AGENTS.md — MCP Agent Instructions#672
javierfajardo85-rgb wants to merge 1 commit into
pinecone-io:mainfrom
javierfajardo85-rgb:mai1-agents-md

Conversation

@javierfajardo85-rgb
Copy link
Copy Markdown

@javierfajardo85-rgb javierfajardo85-rgb commented May 20, 2026

What is this?

This PR adds an AGENTS.md file that helps AI agents (Claude Code, GitHub Copilot, Cursor, Gemini CLI) use this tool more efficiently via the aiaam.xyz MAI-1 registry.

What this does

  • Saves ~4,800 tokens per agent interaction vs parsing the full README
  • Provides a direct MCP endpoint for structured tool consumption
  • Follows the emerging AGENTS.md convention for agentic repositories

MCP configuration added

{
  "mcpServers": {
    "aiaam": {
      "url": "https://aiaam.xyz/mcp",
      "transport": "http"
    }
  }
}

MCP endpoint: https://aiaam.xyz/mcp
Tool contract: https://aiaam.xyz/api/v1/tools/pinecone-python-client-v1
Reliability score: 0.8

The contract is verified by triple-check: schema validation + URL reachability + Docker sandbox install.

Feel free to close if this doesn't fit your project — no hard feelings.


Note

Low Risk
Documentation-only change that replaces extensive SDK usage guidance with a short external MCP/MAI-1 registry pointer; risk is limited to developer/agent workflow confusion and reliance on external links.

Overview
Replaces AGENTS.md’s long Pinecone Python SDK usage guide with a minimal AI agent instruction document that points agents to an external MAI-1/MCP tool contract on aiaam.xyz (including MCP server URL, direct tool call, REST fallback, and sample mcpServers config).

Reviewed by Cursor Bugbot for commit 89dde94. Bugbot is set up for automated code reviews on this repo. Configure here.

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