Getting Started

# Install the library
pip install open-context-agent

from ocp_agent import OCPAgent
import os

# Set your GitHub token
os.environ['GITHUB_TOKEN'] = 'ghp_your_token_here'

# Create an agent with workspace context
agent = OCPAgent(
    agent_type="api_explorer",
    workspace="my-project"
)

# Register an API from OpenAPI spec
api_spec = agent.register_api(
    name="example_api", 
    spec_url="https://petstore3.swagger.io/api/v3/openapi.json"
)
print(f"Discovered {len(api_spec.tools)} tools")

# List available tools
tools = agent.list_tools("example_api")
print(f"Available tools: {[tool.name for tool in tools[:3]]}")

# Call a tool
result = agent.call_tool("findPetsByStatus", {"status": "available"}))

# Install the library
npm install @opencontextprotocol/agent

import { OCPAgent } from '@opencontextprotocol/agent';

// Set environment variable
process.env.GITHUB_TOKEN = 'ghp_your_token_here';

// Create an agent with workspace context
const agent = new OCPAgent(
    'api_explorer',
    undefined,
    'my-project'
);

// Register an API from OpenAPI spec
const apiSpec = await agent.registerApi(
    'example_api',
    'https://petstore3.swagger.io/api/v3/openapi.json'
);
console.log(`Discovered ${apiSpec.tools.length} tools`);

// List available tools
const tools = agent.listTools('example_api');
console.log(`Available tools: ${tools.slice(0, 3).map(t => t.name).join(', ')}`);

// Call a tool
const result = await agent.callTool('findPetsByStatus', {status: 'available'});

# Install the extension
code --install-extension opencontextprotocol.ocp-vscode-extension

{
  "ocp.apiAuth": {
    "petstore": {
      "api_key": "your_api_key_here"
    }
  }
}