mcpField
A
api-setup

api-setup

github.com/blockDevelopment25165 installsUpdated 18w ago
Repository

About api-setup

A skill for setting up a new API integration with a standard configuration template. It covers creating the integration directory, adding credentials, testing connectivity, and troubleshooting common failures.

Key features

  1. 01Integration directory setup
  2. 02JSON configuration template
  3. 03API credential and endpoint configuration
  4. 04Connection verification
  5. 05Timeout and authentication troubleshooting

Use cases

  1. 01Starting a new API integration
  2. 02Configuring an API key and endpoint
  3. 03Diagnosing connection timeouts or 401/403 errors

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/block/agent-skills --skill api-setup

After installing, type/api-setupin Claude Code to confirm it loaded.

Bundled filessetup.shtemplates/config.template.json

Details

From the project README

API Setup

This skill helps you set up a new API integration with our standard configuration.

Steps

  1. Run setup.sh <api-name> to create the integration directory
  2. Copy templates/config.template.json to your integration directory
  3. Update the config with your API credentials
  4. Test the connection

Configuration

The config template includes:

  • api_key: Your API key (get from the provider's dashboard)
  • endpoint: API endpoint URL
  • timeout: Request timeout in seconds (default: 30)

Verification

After setup, verify:

  • Config file is valid JSON
  • API key is set and not a placeholder
  • Test connection succeeds

Troubleshooting

Connection Timeout

If you experience connection timeouts:

  1. Check your network connection
  2. Verify the endpoint URL is correct
  3. Increase the timeout value in config
Authentication Errors

If you get 401/403 errors:

  1. Verify your API key is correct
  2. Check if the key has the required permissions
  3. Ensure the key hasn't expired

Comments

Markdown supported